Spotify hub

Spotify Podcast Episodes API

A podcast's full episode list, 50 a page, from its Spotify id or share link.

GET /v1/spotify/podcast/episodes

1 credit Failed requests are free

About this endpoint

GET /v1/spotify/podcast/episodes takes podcastId or a public url (https://open.spotify.com/show/…). Each page holds up to 50 episodes in the podcast's own order (newest first for most podcasts), each with episodeId, title, description, releaseDate, durationMs, explicit, playable, paywalled, mediaTypes, coverArtUrl, previewUrl and episodeUrl. data.totalCount is the number of episodes the podcast has.

Pass page.nextCursor as cursor, with the same podcast, to get the next page; page.hasMore is false on the last one. An id that does not resolve answers lookupStatus: not_found.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Spotify Podcast Episodes API FAQ

How do I list a Spotify podcast's episodes through an API?

Call GET /v1/spotify/podcast/episodes with your Social Fetch API key (x-api-key) and podcastId or a public open.spotify.com/show/… url. Follow page.nextCursor for more pages.

How much does the Spotify Podcast Episodes API cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.

How many episodes come back per request?

Up to 50. data.totalCount tells you how many the podcast has, so a 900-episode podcast takes 19 pages.

Do I get the episode audio?

No. You get each episode's metadata, a short preview URL when Spotify offers one, and its public Spotify link.