Spotify Podcast Episodes API
A podcast's full episode list, 50 a page, from its Spotify id or share link.
GET /v1/spotify/podcast/episodes1 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.
Example response
A 200 response. Live responses have the same shape with current data.
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.