Spotify hub

Spotify Podcast API

A podcast's details and listener rating from its Spotify id or share link.

GET /v1/spotify/podcast

1 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.

Request
cURL

Example response

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

Request
JSON

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.