CaptapiCaptapi
Spotify · Guide

How to get Spotify podcast episodes

TL;DR
To get Spotify podcast episodes, sign up for a free Captapi key, then send one GET request to /v1/spotify/podcast-episodes with your input. You get clean JSON back in seconds for 2 credits per call — no OAuth, scraping or platform SDKs. Podcast episode archive — previewUrl, releaseDate, explicit, cursor pagination (flat 2 credits).
Get your free API keyAPI reference

How to get Spotify podcast episodes (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the Spotify Podcast Episodes API

    Send an authenticated GET request to /v1/spotify/podcast-episodes with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/spotify/podcast-episodes?url=https%3A%2F%2Fopen.spotify.com%2Fshow%2F4rOoJ6Egrf8K2IrywzwOMk" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "platform": "spotify",
    "podcast": {
      "platform": "spotify",
      "type": "podcast",
      "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk",
      "url": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
      "name": "The Joe Rogan Experience",
      "description": "The official podcast of comedian Joe Rogan.",
      "image": "https://i.scdn.co/image/ab6765630000ba8a8007f4df0a76e787cb94308a",
      "totalEpisodes": 2766,
      "id": "4rOoJ6Egrf8K2IrywzwOMk",
      "publisher": {
        "name": "Joe Rogan"
      },
      "rating": {
        "average": 4.7,
        "totalRatings": 955518
      },
      "topics": [
        {
          "title": "Comedy",
          "uri": "spotify:genre:0JQ5DAqbMKFNr6gDrHHVKL"
        }
      ],
      "contentRating": "EXPLICIT",
      "contentRatingLabels": [
        "EXPLICIT"
      ],
      "explicit": true,
      "mediaType": "MIXED",
      "playable": true,
      "consumptionOrder": "EPISODIC",
      "showTypes": [
        "SHOW_TYPE_EXCLUSIVE"
      ]
    },
    "totalEpisodes": 2766,
    "totalReturned": 2,
    "episodes": [
      {
        "platform": "spotify",
        "type": "episode",
        "uri": "spotify:episode:24C6qd4r0IKDGkytUzYUnM",
        "url": "https://open.spotify.com/episode/24C6qd4r0IKDGkytUzYUnM",
        "name": "#2567 - Mariana van Zeller",
        "description": "Mariana van Zeller is a Peabody and Emmy Award-winning journalist whose credits include \"Trafficked with Mariana van Zeller,\" \"The OxyContin Express,\" and \"Inside Secret America.\" She is also the host of \"The Hidden Third\" podcast. Her latest documentary special, \"Super Scam Me,\" premieres October 17 on National Geographic and will be available to stream on Disney+ and Hulu.https://www.natgeotv.com/za/programs/natgeo/super-scam-mehttps://www.youtube.com/channel/UCoCiI8nJacn8gDiHxr6aQGAhttps://www.patreon.com/cw/TheHiddenThirdhttps://www.imdb.com/name/nm2447662/https://marianavanzeller.me  Perplexity: Download the app or ask Perplexity anything at https://pplx.ai/rogan.  Don’t miss out on all the action this week at DraftKings! Download the DraftKings app today! Sign-up using https://dkng.co/rogan or through my promo code ROGAN. Learn more about your ad choices. Visit podcastchoices.com/adchoices",
        "durationMs": 8657854,
        "durationFormatted": "2:24:17",
        "releaseYear": 2026,
        "image": "https://i.scdn.co/image/ab6765630000ba8a11c7c3e1f347d56a883f02f9",
        "id": "24C6qd4r0IKDGkytUzYUnM",
        "previewUrl": "https://p.scdn.co/mp3-preview/c1e8996f1edecafc9bd636f95507f005d66d053e.mp3",
        "audioUrls": [
          "https://p.scdn.co/mp3-preview/f504025cb9c2f3eaa78abf04c17ea94bd5a9797a",
          "https://p.scdn.co/mp3-preview/53f833623520b7944727e5ba538dda5b9119b8e1"
        ],
        "releaseDate": "2026-10-16T17:00:00Z",
        "mediaTypes": [
          "VIDEO",
          "AUDIO"
        ],
        "hasVideo": true,
        "contentRating": "EXPLICIT",
        "explicit": true,
        "hasTranscripts": false,
        "paywallContent": false,
        "showTypes": [
          "SHOW_TYPE_EXCLUSIVE"
        ],
        "playable": true,
        "htmlDescription": "<p>Mariana van Zeller is a Peabody and Emmy Award-winning journalist whose credits include \"Trafficked with Mariana van Zeller,\" \"The OxyContin Express,\" and \"Inside Secret America.\" She is also the host of \"The Hidden Third\" podcast. Her latest documentary special, \"Super Scam Me,\" premieres October 17 on National Geographic and will be available to stream on Disney+ and Hulu.<br /><a href=\"https://www.natgeotv.com/za/programs/natgeo/super-scam-me\" rel=\"nofollow\">https://www.natgeotv.com/za/programs/natgeo/super-scam-me</a><br /><a href=\"https://www.youtube.com/channel/UCoCiI8nJacn8gDiHxr6aQGA\" rel=\"nofollow\">https://www.youtube.com/channel/UCoCiI8nJacn8gDiHxr6aQGA</a><br /><a href=\"https://www.patreon.com/cw/TheHiddenThird\" rel=\"nofollow\">https://www.patreon.com/cw/TheHiddenThird</a><br /><a href=\"https://www.imdb.com/name/nm2447662/\" rel=\"nofollow\">https://www.imdb.com/name/nm2447662/</a><br /><a href=\"https://marianavanzeller.me/\" rel=\"nofollow\">https://marianavanzeller.me</a></p>\n<p><br /></p>\n<p>Perplexity: Download the app or ask Perplexity anything at <a href=\"https://pplx.ai …"
      },
      {
        "platform": "spotify",
        "type": "episode",
        "uri": "spotify:episode:2sIgfLvsfb5vtiYVcguYNs",
        "url": "https://open.spotify.com/episode/2sIgfLvsfb5vtiYVcguYNs",
        "name": "#2566 - Cody Tucker",
        "description": "Cody Tucker is the host of \"The Cody Tucker Show\" and \"Rewind and Repeat with Cody Tucker\" podcasts and author of \"And Now You Know: Mind-Blowing Stories from History and Pop Culture.\" His new book, \"Where Did That Come From?: The Hidden History of Everyday Words and Phrases,\" is available now.https://a.co/d/0buvONu8https://www.youtube.com/@thecodytuckershowhttps://www.thecodytucker.com  Perplexity: Download the app or ask Perplexity anything at https://pplx.ai/rogan.  Get a free welcome kit with your first subscription of AG1 at https://drinkag1.com/joerogan  Try ZipRecruiter FOR FREE at https://ziprecruiter.com/rogan Learn more about your ad choices. Visit podcastchoices.com/adchoices",
        "durationMs": 9901759,
        "durationFormatted": "2:45:01",
        "releaseYear": 2026,
        "image": "https://i.scdn.co/image/ab6765630000ba8a11f509ab04e773586883c9b8",
        "id": "2sIgfLvsfb5vtiYVcguYNs",
        "previewUrl": "https://p.scdn.co/mp3-preview/dd8f2e9bd2c1de662b6a457069cedeae3692e0a6.mp3",
        "audioUrls": [
          "https://p.scdn.co/mp3-preview/35c11ff9d76ff2971537a16508eeef6cf8e640f0",
          "https://p.scdn.co/mp3-preview/8761d4ce8a0939bd1a5b13bd6c4f5c3c499bdff4"
        ],
        "releaseDate": "2026-10-15T17:00:00Z",
        "mediaTypes": [
          "VIDEO",
          "AUDIO"
        ],
        "hasVideo": true,
        "contentRating": "EXPLICIT",
        "explicit": true,
        "hasTranscripts": false,
        "paywallContent": false,
        "showTypes": [
          "SHOW_TYPE_EXCLUSIVE"
        ],
        "playable": true,
        "htmlDescription": "<p>Cody Tucker is the host of \"The Cody Tucker Show\" and \"Rewind and Repeat with Cody Tucker\" podcasts and author of \"And Now You Know: Mind-Blowing Stories from History and Pop Culture.\" His new book, \"Where Did That Come From?: The Hidden History of Everyday Words and Phrases,\" is available now.<br /><a href=\"https://a.co/d/0buvONu8\" rel=\"nofollow\">https://a.co/d/0buvONu8</a><br /><a href=\"https://www.youtube.com/@thecodytuckershow\" rel=\"nofollow\">https://www.youtube.com/@thecodytuckershow</a><br /><a href=\"https://www.thecodytucker.com/\" rel=\"nofollow\">https://www.thecodytucker.com</a></p>\n<p><br /></p>\n<p>Perplexity: Download the app or ask Perplexity anything at <a href=\"https://pplx.ai/rogan\" rel=\"nofollow\">https://pplx.ai/rogan</a>.</p>\n<p><br /></p>\n<p>Get a free welcome kit with your first subscription of AG1 at <a href=\"https://drinkag1.com/joerogan\" rel=\"nofollow\">https://drinkag1.com/joerogan</a></p>\n<p><br /></p>\n<p>Try ZipRecruiter FOR FREE at <a href=\"https://ziprecruiter.com/rogan\" rel=\"nofollow\">https://ziprecruiter.com/rogan</a></p><p> </p><p>Learn more about your a …"
      }
    ],
    "nextCursor": "2",
    "hasMore": true
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

NameTypeRequiredDescription
urlurl YesSpotify show/podcast URL, URI, or ID (e.g. https://open.spotify.com/show/…). Not an artist URL.
limitintegerNoMax items to return (default 20, max 50). Flat 2 credits per call.
cursorstringNoPagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.
rawbooleanNoInclude slimmed per-episode upstream payload as episodes[].raw. Default false. visualIdentity / playedState / podcastV2 are never included.
cachebooleanNoSet true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

Frequently asked questions

What does the Spotify Podcast Episodes API do?

The Spotify Podcast Episodes API lets you list items in bulk with metadata from a public Spotify podcast episodes using one GET request to /v1/spotify/podcast-episodes. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Spotify Podcast Episodes API cost?

Each successful call costs 2 credits. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.

Do I need a Spotify API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle access, rate limits, retries, and authentication for you.

Do you ship visualIdentity / raw color dumps?

No — same rule as /spotify/podcast. visualIdentity, playedState, and per-episode podcastV2 show copies are stripped. Pass raw=true only for a slimmed upstream payload; default responses omit raw entirely.

How do I page past the newest 50 episodes?

Pass cursor=nextCursor from the previous response (integer offset). hasMore is false at the end of the archive. Flat 2 credits per page on native Pathfinder.

Why can totalEpisodes differ from an older /spotify/podcast call?

This endpoint sets totalEpisodes from the same episodesV2 query as the page so the embedded podcast card cannot drift within one response. A separate /spotify/podcast call moments later can still see a new episode published.

Is the Spotify Podcast Episodes API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

Ready to get Spotify podcast episodes?

Start free with 100 credits — no credit card required.

Get your free API key