Skip to content
Pod Engine
Spotify podcast API

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.

My First Million podcast cover art

The one Spotify call that needs no token: oEmbed, for My First Million.

Spotify oEmbed, no token 200 OK
$ 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
}
Run on 26 Oct 2026. It returns an embed and the newest episode’s title, not show data. Trimmed: the embed HTML and thumbnail URL left out.

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
What Spotify Web API and the Pod Engine API return for a podcast
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.

Spotify Get Show, no token 401 Unauthorized
$ curl "https://api.spotify.com/v1/shows/3mliji9352UAk3XnWElnDV?market=US"

{
  "error": {
    "status": 401,
    "message": "Missing/invalid/expired access token"
  }
}
Run on 26 Oct 2026 for My First Million, with no 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.

Transcripts

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.

Learn more about podcast transcripts

MY FIRST MILLION How to find your… 26 OCT 2026 Essentially, you were looking forarbitrages. You’re looking for some sort ofmispricing. I am now convinced that every arbis just about time scale.
Three lines from the transcript of My First Million’s episode of 26 Oct 2026.
Ratings

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.
My First Million RATINGS BY PLATFORM Spotify 5,295 ratings 4.8 Apple Podcasts 2,617 ratings 4.7
My First Million is rated 4.7 from 2,617 ratings on Apple Podcasts (US) and 4.8 from 5,295 on Spotify (Pod Engine data, 17 Oct 2026).
Chart history

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 podcast cover art

My First Million · Spotify Business chart, US

#1 #18 #35 25 May 13 Jul 31 Aug 19 Oct
Average position each week, 25 May to 19 Oct 2026. My First Million was No. 27 on the Spotify Business chart, US, on 26 Oct 2026 (Pod Engine chart record).

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

    Call Spotify’s Get Show

    With your Spotify access token, read the show’s name, description and episodes.

  2. 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. 3

    Read the record and ratings

    The show record has rssFeedUrl, appleId and spotifyId. All details adds Spotify and Apple ratings.

  4. 4

    Get the transcripts

    List the episodes that have a transcript, then download one as TXT or VTT.

  5. 5

    Pull the chart history

    Ask for the show’s Spotify chart history by the same Spotify ID.

Spotify, then Pod Engine, for show ID 3mliji9352UAk3XnWElnDV
Language
        # 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.

Pod Engine responses
Language
        // 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 documentation
Do 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 modes
How 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 changes
Can 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 charts
Can 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 transcripts

Add what Spotify’s API leaves out

API access is included in every paid plan.