JellypodJellypod
Podcasts

List podcasts

GET
/podcasts

Returns a paginated list of podcasts in the organization.

Authorization

BearerAuth
AuthorizationBearer <token>

Jellypod API key. Create and manage keys from the Jellypod dashboard under Settings → API Keys.

In: header

Query Parameters

cursor?string

Opaque cursor from a previous response's next_cursor field. Omit for the first page.

limit?integer

Number of items to return per page.

Default20
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

curl -X GET "https://api.jellypod.com/v1/podcasts"
{
  "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"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "string"
  }
}

Was this page helpful?

Unpublish an episode POST

Unpublish or unschedule an episode, reverting it to `draft` status. The episode must be in `published` or `scheduled` status. Returns `422` if the episode is in any other status.

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`.