Spotify podcast API
What the Spotify Web API returns for shows and episodes, what it takes to call it, and how to add transcripts, ratings and chart history.
The one Spotify call that needs no token: oEmbed, for My First Million.
$ curl "https://open.spotify.com/oembed?url=https://open.spotify.com/show/3mliji9352UAk3XnWElnDV"
{
"provider_name": "Spotify",
"type": "video",
"title": "How to find your arbitrage (from the guy who’s done it 3x) ft. Nick Kokonas",
"width": 624,
"height": 351
} What the Spotify Web API returns, and what it doesn’t
For developers and AI teams checking whether Spotify’s API returns what their product needs.
The Spotify Web API searches Spotify’s podcast catalog and returns a show’s name, description, cover art, languages and episodes. Every call needs an access token from a Spotify app, and the app’s owner needs Premium. It returns no transcripts, ratings, chart positions or listener numbers. Pod Engine returns those for the same Spotify ID.
Each Spotify row links to the Spotify page it was checked on.
Checked · 26 Oct 2026| Data | Spotify Web API | Pod Engine API |
|---|---|---|
| Search shows and episodes | Yes. Search with type=show or episode Spotify: Search | Yes. Search titles, descriptions and transcripts |
| Look a show up by its Spotify ID | Yes. Get Show Spotify: Get Show | Yes. GET /podcasts/id/lookup?spotifyId= gives our id; it doesn’t count towards podcast lookups |
| Name, description, cover art, languages | Yes. Fields on the show object Spotify: Get Show | Yes. title, description, imageUrl and language on the show record |
| A show’s episodes | Yes. Get Show Episodes Spotify: Get Show Episodes | Yes. GET /podcasts/{id}/episodes, up to 100 a page, every page |
| RSS feed address | No. Not a field on the show object Spotify: Get Show | Yes. rssFeedUrl on GET /podcasts/{id} |
| Full transcripts with timestamps | No. Not a field on the episode object Spotify: Get Episode | Yes. Every transcribed episode, as TXT or VTT |
| Ratings and review counts | No. Not a field on the show object Spotify: Get Show | Yes. reviews.applePodcastsReview and spotifyReview on /all-details |
| Chart positions | No. No chart endpoint in the reference Spotify Web API overview | Yes. Apple and Spotify charts, recorded daily, with history |
| Monthly listeners | No. Not a field on the show object Spotify: Get Show | Yes. audienceEstimate.estimatedMonthlyListeners, where we have one |
| The same show’s Apple ID | No. Spotify IDs only Spotify: Get Show | Yes. appleId and spotifyId on GET /podcasts/{id} |
| API | What it returns |
|---|---|
| Search shows and episodes | |
| Spotify | Yes. Search with type=show or episode Spotify: Search |
| Pod Engine | Yes. Search titles, descriptions and transcripts |
| Look a show up by its Spotify ID | |
| Spotify | Yes. Get Show Spotify: Get Show |
| Pod Engine | Yes. GET /podcasts/id/lookup?spotifyId= gives our id; it doesn’t count towards podcast lookups |
| Name, description, cover art, languages | |
| Spotify | Yes. Fields on the show object Spotify: Get Show |
| Pod Engine | Yes. title, description, imageUrl and language on the show record |
| A show’s episodes | |
| Spotify | Yes. Get Show Episodes Spotify: Get Show Episodes |
| Pod Engine | Yes. GET /podcasts/{id}/episodes, up to 100 a page, every page |
| RSS feed address | |
| Spotify | No. Not a field on the show object Spotify: Get Show |
| Pod Engine | Yes. rssFeedUrl on GET /podcasts/{id} |
| Full transcripts with timestamps | |
| Spotify | No. Not a field on the episode object Spotify: Get Episode |
| Pod Engine | Yes. Every transcribed episode, as TXT or VTT |
| Ratings and review counts | |
| Spotify | No. Not a field on the show object Spotify: Get Show |
| Pod Engine | Yes. reviews.applePodcastsReview and spotifyReview on /all-details |
| Chart positions | |
| Spotify | No. No chart endpoint in the reference Spotify Web API overview |
| Pod Engine | Yes. Apple and Spotify charts, recorded daily, with history |
| Monthly listeners | |
| Spotify | No. Not a field on the show object Spotify: Get Show |
| Pod Engine | Yes. audienceEstimate.estimatedMonthlyListeners, where we have one |
| The same show’s Apple ID | |
| Spotify | No. Spotify IDs only Spotify: Get Show |
| Pod Engine | Yes. appleId and spotifyId on GET /podcasts/{id} |
Estimated monthly listeners is Pod Engine’s estimate of a show’s monthly audience across podcast apps and YouTube. About monthly listeners.
Spotify column checked against Spotify’s own documentation on 26 Oct 2026. Pod Engine column checked against our API reference on the same day.
What you need before you call the Spotify Web API
The account, token and limits, each from Spotify’s own documentation.
- Account
- A Spotify Premium account, to create an app Spotify Web API overview
- Token
- Client ID and secret, then an access token that lasts one hour Spotify: Access Token
- Users
- Up to 5 per app in development mode, the mode every new app starts in Spotify: Quota modes
- More users
- Extended quota mode: organizations only, with at least 250k monthly active users Spotify: Quota modes
- Search results
- Up to 10 a call, 5 by default, for apps in development mode Spotify: February 2026 changes
- Paging
- offset=0 to 1,000 on search Spotify: Search
- Rate limit
- Counted over a rolling 30 seconds. Spotify publishes no figure Spotify: Rate limits
- Market
- With no market and no user token, Spotify treats the content as unavailable Spotify: Get Show
- Uploading
- Spotify’s docs describe no endpoint for uploading episodes Spotify Web API overview
- With no token
- The oEmbed API needs none. It returns an embed and a title, not show data Spotify: oEmbed API
Without a token, Get Show answers 401. Every Web API call needs one.
$ curl "https://api.spotify.com/v1/shows/3mliji9352UAk3XnWElnDV?market=US"
{
"error": {
"status": 401,
"message": "Missing/invalid/expired access token"
}
} What Spotify’s API leaves out, for the same show
The same Spotify ID gets you My First Million’s transcripts, ratings and Spotify chart history from Pod Engine.
Read what was said in the episode
Get the full text of every transcribed episode, or each sentence with its start and end time.
- Download it as TXT or VTT.
- Search inside transcripts by word or exact phrase.
- We transcribe show by show. Request any episode that’s missing.
See how listeners rate the show
Read a show’s Apple Podcasts and Spotify ratings and how many people gave them, on one record.
- Apple ratings by country.
- Apple review text through the reviews endpoint.
Follow the show’s chart position, week by week
We record the Apple Podcasts and Spotify charts daily and keep each show’s history. Look it up by the Spotify ID you already have.
- Daily positions, or weekly for longer ranges.
- Movement and every chart a show appears on.
My First Million · Spotify Business chart, US
Use Spotify’s API and ours by the same ID
Start from the Spotify show ID you already have. No matching shows by name.
- 1
Call Spotify’s Get Show
With your Spotify access token, read the show’s name, description and episodes.
- 2
Find the show in Pod Engine
The ID lookup turns the Spotify ID into our id. It doesn’t count towards your podcast lookups.
- 3
Read the record and ratings
The show record has rssFeedUrl, appleId and spotifyId. All details adds Spotify and Apple ratings.
- 4
Get the transcripts
List the episodes that have a transcript, then download one as TXT or VTT.
- 5
Pull the chart history
Ask for the show’s Spotify chart history by the same Spotify ID.
# 1 Spotify: the show's details (needs a Spotify access token)
curl "https://api.spotify.com/v1/shows/3mliji9352UAk3XnWElnDV?market=US" \
-H "Authorization: Bearer $SPOTIFY_ACCESS_TOKEN"
# 2 Pod Engine: find our id for the same show (doesn't count towards podcast lookups)
curl "https://api.podengine.ai/api/v1/podcasts/id/lookup?spotifyId=3mliji9352UAk3XnWElnDV" \
-H "Authorization: Bearer $PODENGINE_API_KEY"
# 3 The show record: rssFeedUrl, appleId and spotifyId
curl "https://api.podengine.ai/api/v1/podcasts/$PODCAST_ID" \
-H "Authorization: Bearer $PODENGINE_API_KEY"
# 3 Ratings: reviews.applePodcastsReview and reviews.spotifyReview
curl "https://api.podengine.ai/api/v1/podcasts/$PODCAST_ID/all-details" \
-H "Authorization: Bearer $PODENGINE_API_KEY"
# 4 Transcripts: episodes that have one, then the newest as VTT, a sentence a cue
curl "https://api.podengine.ai/api/v1/podcasts/$PODCAST_ID/episodes?hasTranscript=true&limit=10" \
-H "Authorization: Bearer $PODENGINE_API_KEY"
curl "https://api.podengine.ai/api/v1/episodes/$EPISODE_ID/download/transcript?format=sentence-vtt" \
-H "Authorization: Bearer $PODENGINE_API_KEY"
# 5 Chart history, by the Spotify ID
curl "https://api.podengine.ai/api/v1/charts/podcast-history?identityType=platform&platformId=3mliji9352UAk3XnWElnDV&chartType=spotify&category=business&range=6m" \
-H "Authorization: Bearer $PODENGINE_API_KEY"
import { PodEngine } from '@podengine/sdk';
const pe = new PodEngine({ apiKey: process.env.PODENGINE_API_KEY! });
const spotifyId = '3mliji9352UAk3XnWElnDV';
// 1 Spotify: the show's details (needs a Spotify access token)
const res = await fetch(`https://api.spotify.com/v1/shows/${spotifyId}?market=US`, {
headers: { Authorization: `Bearer ${process.env.SPOTIFY_ACCESS_TOKEN}` },
});
if (!res.ok) throw new Error(`Spotify Get Show failed: ${res.status}`);
const spotify = await res.json();
// 2 Find our id for the same show
const { podcast: found } = await pe.podcasts.getPodcastIdLookup({ spotifyId: spotifyId });
if (!found) throw new Error('Pod Engine does not track this show');
// 3 The show record: rssFeedUrl, appleId and spotifyId
const { podcast } = await pe.podcasts.getPodcast({ podcastIdOrSlug: found.id });
// 3 Ratings
const all = await pe.podcasts.getPodcastAllDetails({ podcastIdOrSlug: found.id });
const { applePodcastsReview, spotifyReview } = all.podcast.reviews ?? {};
// 4 Transcripts: episodes that have one, then the newest as VTT, a sentence a cue
const { podcastWithEpisodes } = await pe.podcasts.getPodcastEpisodes({
podcastIdOrSlug: found.id,
hasTranscript: true,
limit: 10,
});
const episodeId = podcastWithEpisodes.episodes[0]!.episodeId;
const vtt = await pe.episodes.downloadEpisodeTranscript({ episodeId, format: 'sentence-vtt' });
// 5 Chart history, by the same ID
const { history } = await pe.charts.getPodcastChartHistory({
identityType: 'platform',
platformId: String(spotifyId),
chartType: 'spotify',
category: 'business',
range: '6m',
});
npm install @podengine/sdk
import os
import requests
from podengine import PodEngine
pe = PodEngine(api_key=os.environ["PODENGINE_API_KEY"])
spotify_id = "3mliji9352UAk3XnWElnDV"
# 1 Spotify: the show's details (needs a Spotify access token)
res = requests.get(
f"https://api.spotify.com/v1/shows/{spotify_id}",
params={"market": "US"},
headers={"Authorization": f"Bearer {os.environ['SPOTIFY_ACCESS_TOKEN']}"},
)
res.raise_for_status()
spotify = res.json()
# 2 Find our id for the same show
found = pe.podcasts.get_podcast_id_lookup(spotify_id=spotify_id).podcast
podcast_id = found.id
# 3 The show record: rssFeedUrl, appleId and spotifyId
record = pe.podcasts.get_podcast(podcast_id_or_slug=podcast_id)
# 3 Ratings: reviews.applePodcastsReview and reviews.spotifyReview
details = pe.podcasts.get_podcast_all_details(podcast_id_or_slug=podcast_id)
# 4 Transcripts: episodes that have one, then the newest as VTT, a sentence a cue
page = pe.podcasts.get_podcast_episodes(podcast_id_or_slug=podcast_id, has_transcript=True, limit=10)
episode_id = page.podcast_with_episodes.episodes[0].episode_id
vtt = pe.episodes.download_episode_transcript(episode_id=episode_id, format="sentence-vtt")
# 5 Chart history, by the same ID
history = pe.charts.get_podcast_chart_history(
identity_type="platform",
platform_id=str(spotify_id),
chart_type="spotify",
category="business",
range="6m",
)
pip install podengine
What came back when we ran these requests on 4 Nov 2026, trimmed. Every field is in the API docs.
// GET /api/v1/podcasts/id/lookup?spotifyId=3mliji9352UAk3XnWElnDV
// 200 OK
{
"status": "OK",
"data": {
"podcast": {
"author": "Hubspot Media",
"genres": ["business"],
"id": "e9bc28ff-7a4c-4ea2-b8d5-b8b7c2dcbce5",
"language": "en",
"lastEpisodePublishedAt": "2026-11-04T12:19:00.000Z",
"slug": "my-first-million",
"title": "My First Million",
"titleLatest": "My First Million"
}
}
}
Left out: authorityScore and imageUrl.
// GET /api/v1/podcasts/e9bc28ff-7a4c-4ea2-b8d5-b8b7c2dcbce5
// 200 OK
{
"status": "OK",
"data": {
"podcast": {
"id": "e9bc28ff-7a4c-4ea2-b8d5-b8b7c2dcbce5",
"appleId": 1469759170,
"author": "Hubspot Media",
"spotifyId": "3mliji9352UAk3XnWElnDV",
"rssFeedUrl": "https://feeds.megaphone.fm/HS2300184645",
"stats": { "episodeCount": 932, "transcriptsCount": 929 },
"hostNames": ["Sam Parr", "Shaan Puri"],
"title": "My First Million"
}
}
}
// GET /api/v1/podcasts/e9bc28ff-7a4c-4ea2-b8d5-b8b7c2dcbce5/all-details
// 200 OK
{
"status": "OK",
"data": {
"podcast": {
"reviews": {
"applePodcastsReview": {
"scrapedAt": "2026-10-17T20:16:24.736Z",
"country": "us",
"reviewsCount": 2617,
"rating": 4.7
},
"spotifyReview": {
"scrapedAt": "2026-10-17T22:37:29.303Z",
"reviewsCount": 5295,
"rating": 4.773748819641181
}
}
}
}
}
Left out: most record fields, contacts and the audience estimate among them, and most review fields: star counts, other countries and Castbox.
// GET /api/v1/podcasts/e9bc28ff-7a4c-4ea2-b8d5-b8b7c2dcbce5/episodes?hasTranscript=true&limit=10
// 200 OK
{
"status": "OK",
"data": {
"totalEpisodes": 932,
"totalTranscripts": 929,
"podcastWithEpisodes": {
"episodes": [
{
"episodeId": "da049e3c-4e4a-49cd-8155-d2d569fe56fe",
"publishedAt": "2026-11-02T10:00:00.000Z",
"title": "$100M hedge fund manager: Do not make the mistake of dying rich",
"hasTranscript": true,
"durationSeconds": 4950
},
{
"episodeId": "48405a81-f2bc-412b-8ec8-d1b46778aa2d",
"publishedAt": "2026-10-28T11:01:00.000Z",
"title": "Ex-Amazon VP tells us what it’s really like working with Jeff Bezos",
"hasTranscript": true,
"durationSeconds": 4506
}
]
}
}
}
// GET /api/v1/episodes/da049e3c-4e4a-49cd-8155-d2d569fe56fe/download/transcript?format=sentence-vtt
// 200 OK · text/vtt
WEBVTT
00:52.321 --> 00:54.721
That is how I discovered you.
00:54.721 --> 00:59.883
And so we're going to talk – I want to talk a little bit about both, the making of as well as the using of money.
00:59.883 --> 01:03.324
And so maybe we start with – can you just explain how did you make your money?
01:03.324 --> 01:06.841
I made my money – the original – pool of capital.
01:06.841 --> 01:08.321
I made my money trading commodities.
Left out: 8 of the 10 episodes and most episode fields; the transcript’s first cue (the 52-second cold open) and every cue after 01:08.
// GET /api/v1/charts/podcast-history?identityType=platform&platformId=3mliji9352UAk3XnWElnDV&chartType=spotify&category=business&range=6m
// 200 OK
{
"status": "OK",
"data": {
"history": {
"chart": {
"chartType": "spotify",
"country": "us",
"category": "business",
"earliestChartDate": "2024-10-21",
"latestChartDate": "2026-11-03"
},
"range": { "range": "6m", "startDate": "2026-05-04", "endDate": "2026-11-03" },
"stats": {
"bestPosition": 5,
"averagePositionWhenCharting": 24.376543209876544,
"daysOnChart": 162,
"missingDays": 22
},
"series": {
"resolution": "weekly",
"buckets": [
{
"startDate": "2026-10-26",
"endDate": "2026-11-01",
"bestPosition": 27,
"averagePosition": 31.571428571428573,
"daysCharted": 7
}
]
}
}
}
}
Left out: the show’s identity, part of stats, and 26 of the 27 weekly buckets (the week of 26 Oct is shown).
Your Pod Engine key is in API & developers in your team settings. API access is included in every paid plan.
Spotify podcast API questions
Does Spotify have a podcast API?
Yes. The Spotify Web API searches shows and episodes and returns details such as name, description, cover art, languages and episode count. It returns no transcripts, ratings, chart positions or listener numbers, and every call needs an access token.
Spotify’s Web API documentationDo I need Spotify Premium to use the Web API?
Yes. Spotify’s Web API overview says you need a Premium account, and an app in development mode stops working if its owner’s Premium lapses. A development mode app can have up to 5 users (Spotify’s quota modes page, read 26 Oct 2026).
Spotify’s quota modesHow many results does the Spotify search endpoint return?
Up to 10 per request, and 5 by default, for apps in development mode since Spotify’s February 2026 changes (Spotify’s docs, read 26 Oct 2026). To get more, page through the results with the offset parameter, which goes up to 1,000.
Spotify’s February 2026 changesCan I get Spotify podcast chart positions from an API?
Not from the Spotify Web API, whose reference has no chart endpoint. Pod Engine records the Spotify podcast charts daily and returns a show’s chart history by its Spotify ID, beside its Apple chart history.
Podcast chartsCan I get a Spotify podcast transcript through the API?
Not through the Spotify Web API: its episode object has no transcript field. Pod Engine returns transcripts with timestamps for every transcribed episode, found by the show’s Spotify ID, and takes requests for episodes it hasn’t transcribed.
Download podcast transcriptsAdd what Spotify’s API leaves out
API access is included in every paid plan.
