Spotify Podcast API
A podcast's details and listener rating from its Spotify id or share link.
GET /v1/spotify/podcast1 credit Failed requests are free
About this endpoint
GET /v1/spotify/podcast takes podcastId or a public url (https://open.spotify.com/show/…; Spotify calls podcasts shows). A found podcast returns data.podcast with title, publisher, description, coverArtUrl, podcastUrl, mediaType (audio, video or mixed), explicit, playable, topics and rating (average out of 5 and the number of ratings, when Spotify shows one).
Check data.lookupStatus first: an id that does not resolve answers not_found. For the episodes, call GET /v1/spotify/podcast/episodes with the same id.
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 API FAQ
How do I get Spotify podcast details through an API?
Call GET /v1/spotify/podcast with your Social Fetch API key (x-api-key) and either podcastId or a public open.spotify.com/show/… url. Read data.lookupStatus, then data.podcast.
How much does the Spotify Podcast 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.
Does the response include the podcast's episodes?
No. This route returns the podcast itself. List its episodes with GET /v1/spotify/podcast/episodes, 50 a page.
Why do Spotify podcast URLs say show?
Spotify calls podcasts shows, so a podcast's public link is open.spotify.com/show/{id}. Pass that URL, or the id after /show/, as podcastId.