Spotify

Spotify Podcast Episodes API

Podcast episode archive — previewUrl, releaseDate, explicit, cursor pagination (flat 2 credits).

Pass a Spotify show/podcast URL, URI, or ID (not an artist URL). Returns the show card plus episodes[{id, name, description, releaseDate, durationMs, previewUrl, audioUrls[], mediaTypes, hasVideo, contentRating/explicit, hasTranscripts, paywallContent, showTypes}]. totalEpisodes comes from the same episodes query as the page (no drift vs a separate show fetch). Cursor pagination via nextCursor/hasMore (offset into the archive; limit max 50). Flat 2 credits per call on native Pathfinder. Same anti-bloat rule as /spotify/podcast: no visualIdentity color dumps, no playedState, no per-episode podcastV2 show copies — raw is opt-in (?raw=true) and still slimmed.

Docs: https://captapi.com/apis/spotify-podcast-episodes

get/v1/spotify/podcast-episodes

Request

  • Base URL: https://api.captapi.com
  • URL: https://api.captapi.com/v1/spotify/podcast-episodes
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

urlstring required

Spotify show/podcast URL, URI, or ID (e.g. https://open.spotify.com/show/…). Not an artist URL.

limitinteger

Max items to return (default 20, max 50). Flat 2 credits per call.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.

rawboolean

Include slimmed per-episode upstream payload as episodes[].raw. Default false. visualIdentity / playedState / podcastV2 are never included.

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

Response

Success. The data object for this endpoint.

successunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.