Get a podcast
Retrieve a single podcast by ID, including a list of episode IDs.
Use GET /v1/episodes/{episode_id} to fetch individual episode details.
Authorization
BearerAuth Jellypod API key. Create and manage keys from the Jellypod dashboard under Settings → API Keys.
In: header
Path Parameters
The podcast's unique identifier.
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://api.jellypod.com/v1/podcasts/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"title": "The AI Revolution",
"description": "A deep dive into how artificial intelligence is transforming industries.",
"image_url": null,
"host_ids": [
"xK9mQ2pL"
],
"languages": [
"en"
],
"show_order": "episodic",
"show_visibility": "unlisted",
"url": "https://the-ai-revolution-a1b2c3.jellypod.com",
"rss_feed_url": "https://the-ai-revolution-a1b2c3.jellypod.com/rss.xml",
"episode_ids": [
"d4e5f6a7-b8c9-0123-def4-567890abcdef"
],
"created_at": "2026-03-01T10:00:00.000Z",
"updated_at": "2026-03-01T10:00:30.000Z"
}
}{
"error": {
"code": "bad_request",
"message": "string",
"request_id": "string",
"details": [
{
"field": "string",
"message": "string"
}
]
}
}{
"error": {
"code": "bad_request",
"message": "string",
"request_id": "string",
"details": [
{
"field": "string",
"message": "string"
}
]
}
}{
"error": {
"code": "bad_request",
"message": "string",
"request_id": "string",
"details": [
{
"field": "string",
"message": "string"
}
]
}
}Was this page helpful?
Create a podcast POST
Create a new podcast with metadata only (no episode generation). Use `POST /v1/podcasts/generate` to create a podcast and generate episodes in one step, or use this endpoint for manual podcast creation. A cover image is automatically generated in the background. The `image_url` field will be `null` in the response and populated once generation completes. Use `GET /v1/podcasts/{id}` to check, or upload your own via `PUT /v1/podcasts/{id}/image`.
Update a podcast PATCH
Update a podcast. Only include fields you want to change.