Podcast discovery
Use Spotify Podcasts endpoints to turn podcast discovery into repeatable API requests with documented inputs and JSON responses.
Turn Spotify podcast discovery, chart, show, and episode pages into structured data for research and agents.
Collect Spotify Podcasts home, category, chart, show, episode, recommendation, and search data through structured API endpoints.
Endpoint families
6
Documented params
42
Examples
8
Live catalog snapshot
Active endpoints
8
Methods
GET
Required params
9
Schema refs
8
{
"platform": "Spotify Podcasts",
"endpoint": "spotify-podcasts-categories",
"method": "GET",
"path": "/spotify-podcasts/categories",
"auth": "apiKey"
}Related use cases
Use cases
Collect Spotify Podcasts home, category, chart, show, episode, recommendation, and search data through structured API endpoints.
Use Spotify Podcasts endpoints to turn podcast discovery into repeatable API requests with documented inputs and JSON responses.
Use Spotify Podcasts endpoints to turn show and episode research into repeatable API requests with documented inputs and JSON responses.
Use Spotify Podcasts endpoints to turn podcast chart monitoring into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Spotify Podcasts endpoint catalog — 8 endpoints, 42 documented request parameters, and 8 published response schemas — the same catalog Docs and Playground run against.
8 documented Spotify Podcasts endpoints, grouped into 6 request families — Show, Categories and Charts, plus 3 more.
42 request parameters are documented across those Spotify Podcasts endpoints, 9 of them required — the full input contract is public before you write any integration code.
8 of the 8 Spotify Podcasts endpoints ship a recorded example response, and 8 carry a documented response schema — you can code against the real JSON before the first request.
Spotify Podcasts endpoints document their error responses (400, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
8 hosted MCP tools back the Spotify Podcasts endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
/spotify-podcasts/show
/spotify-podcasts/categories
/spotify-podcasts/charts
/spotify-podcasts/episode
/spotify-podcasts/home
/spotify-podcasts/search
Endpoint catalog
/spotify-podcasts/categoriesReturns the Spotify podcast categories page as sections of items such as Arts, for `uri` (default `spotify:page:0JQ5DArNBzkmxXHCqFLx2U`). Each section has a title, `totalCount` and items with title, image and Spotify URL. `page_limit` and `section_limit` default to 10 and run 1 to 50; the offsets default to 0.
Response notes
- Upstream failures return `503`. - The response uses the same section and item shape as `/api/v1/spotify-podcasts/home`.
Sampled 14 Oct 2026: 8 items, 5 fields filled in every item. totalCount: 1 to 11, median 5; uri: “spotify:section:0JQ5DAwD41j3pUtXUsNyCn” and 7 other values.
MCP tool spotify_podcasts_categories
/spotify-podcasts/chartsReturns Spotify podcast chart rankings from podcastcharts.byspotify.com. The chart and region parameters are validated against Spotify's supported podcast chart slugs and countries. Category charts are available only in au, br, de, gb, mx, se, and us.
Response notes
- Invalid `chart` or `region` values return `400`. - `top-podcasts`, `top-episodes`, and `trending` support all listed regions. Category charts support `au`, `br`, `de`, `gb`, `mx`, `se`, and `us`. - `top-episodes` items include episode fields plus the parent show fields when Spotify returns them. - Upstream chart failures return `503`. - `items[].rank` is assigned from the upstream array order.
Sampled 14 Oct 2026: 50 items, 14 fields filled in every item. rankMove: UNCHANGED (32), UP (10), DOWN (8); rank: 1 to 50, median 25.
MCP tool spotify_podcasts_charts
/spotify-podcasts/episodeReturns public episode metadata. Provide either uri or id; defaults to a known public episode when omitted.
Response notes
- Invalid Spotify episode IDs or URLs return `400`. - Upstream failures return `503`. - The response includes episode metadata, HTML descriptions, release precision, playability and paywall hints, audio preview URLs, video thumbnails, transcript counts, share links, and parent show metadata when available.
Sampled 14 Oct 2026: 29 of 29 fields returned with a value. releaseDate: 2026-05-08; durationMs: 9,761,982.
MCP tool spotify_podcasts_episode
/spotify-podcasts/homeReturns the Spotify podcasts home page as sections of items, for `uri` (default `spotify:genre:podcasts-web`). Each section has a title and items with type, title, publisher, images and Spotify URL. `page_limit` and `section_limit` default to 10 and run 1 to 50; the offsets default to 0.
Response notes
- Upstream failures return `503`. - The response includes section titles, item metadata, image assets, external Spotify URLs, and fetch metadata.
Sampled 14 Oct 2026: 2 items, 4 fields filled in every item, 1 not. totalCount: 1 to 9, median 1; uri: “spotify:section:0JQ5DAwD41iTh6T8ay5IzN” and 1 other value.
MCP tool spotify_podcasts_home
/spotify-podcasts/searchSearches Spotify podcasts for `q`, returning matching `shows`, `episodes` and `topResults`, with counts in `meta`. `limit` and `number_of_top_results` run 1 to 50. Optional flags (`include_pre_releases`, `include_audiobooks`, `include_authors`) widen the results. Episodes carry duration and release date; shows carry publisher.
Sampled 14 Oct 2026: 30 items, 9 fields filled in every item, 1 not. releaseDate: 2024-09-01 to 2026-10-09; durationMs: 187,872 to 7,236,081, median 1,882,592.
MCP tool spotify_podcasts_search
/spotify-podcasts/showReturns metadata for one Spotify podcast show by `uri` (default `spotify:show:1QQJ7FElLE0K6CIfZNCxU4`): name, publisher, description, media type, explicit flag, `totalEpisodes`, cover images and Spotify URL. The two `include_` flags request extra content capability and content rating fields when Spotify supplies them.
Sampled 14 Oct 2026: 3 items, 3 fields filled in every item. url: i.scdn.co.
MCP tool spotify_podcasts_show
/spotify-podcasts/show/episodesReturns the episodes of a Spotify podcast by show URI, with `offset` and `limit` (1-50). Each episode has its name, description, release date, duration in milliseconds, explicit and playable flags, Spotify URI, external URL and images; `total` gives the show's episode count.
Sampled 14 Oct 2026: 40 items, 10 fields filled in every item. releaseDate: 2025-05-14 to 2026-09-30; durationMs: 4,113,984 to 9,686,909, median 5,394,560.
MCP tool spotify_podcasts_show_episodes
/spotify-podcasts/show/recommendationsLists shows and episodes that Spotify recommends alongside a podcast show given by `uri`. Each recommendation has a type, title, publisher, description, images and Spotify URL, and `meta.count` gives the number returned. The response echoes the show `uri` it was requested for.
Sampled 14 Oct 2026: 9 items, 8 fields filled in every item. uri: “spotify:show:15T8pm3JcVIxSGIebmdKDg” and 8 other values; imageUrl: i.scdn.co.
MCP tool spotify_podcasts_show_recommendations
Related APIs
Audio & Podcast Platforms
Build audio intelligence workflows from Spotify catalog and public profile signals without maintaining Spotify scrapers.
Audio & Podcast Platforms
Turn SoundCloud's tracks, playlists, user profiles, and search results into structured JSON — plays, likes, comments, artwork, and uploader details — as normalized data. Credential-free.
Audio & Podcast Platforms
Extract Apple Podcasts chart rankings, related-show recommendations, curated New shelves, show metadata, episodes, and search results as structured JSON for podcast discovery, chart tracking, and catalog enrichment.
How to scrape Spotify Podcasts
Spotify's official Web API covers shows and episodes you already have ids for, but not the podcast charts or the browse surfaces its own apps render. Crawlora's 8 Spotify Podcasts endpoints return search, categories, home and chart rows, show metadata, episodes, and recommendations as normalized JSON. A pull on 2026-10-27 of the US top-podcasts chart reported limit 100 but returned 200 items led by The Joe Rogan Experience, and a history search returned 24 top results.
Search podcasts by free-text q, or read the categories and home endpoints for the sectioned browse surfaces Spotify renders in its apps.
The charts endpoint takes a chart such as top-podcasts, top-episodes, or trending — plus per-genre charts like comedy, news, or true-crime — and a two-letter region from the documented market list.
Show metadata and show-episodes take a Spotify uri; episode detail takes a uri or an id.
Show recommendations returns related shows for a uri, which is how you build a topic graph rather than a flat list.
charts returned chart top-podcasts, region us, a limit of 100 and 200 items, each with rank, a spotify:show URI, rankMove (UNCHANGED for the first) and publisher. Count the rows you receive.
search for history returned a limit of 30, 24 topResults (the first The Rest Is History, publisher Goalhanger) and 4 shows. The sections overlap in content, so dedupe by uri.
Client libraries
Install the dedicated Spotify client for your language. Each package covers the Spotify endpoints on this page and calls Crawlora's hosted API with your API key.
npm install @crawlora-org/spotifynpmgo get github.com/Crawlora-org/crawlora-spotifypkg.go.devgem install crawlora-spotifyRubyGemsnet.crawlora:crawlora-spotifyMaven Centralcomposer require crawlora/spotifyPackagistcargo add crawlora-spotifycrates.ioAgent skills
Install a Crawlora agent skill and your agent can pull Spotify Podcasts data as JSON through the documented API, without writing a scraper. These skills cover Spotify Podcasts:
Discovers and compares public podcast shows, episodes, charts, rankings, and related programs using Apple Podcasts and Spotify Podcasts through the…
npx skills add github.com/Crawlora-org/crawlora-skills --skill podcast-discovery-researchMap podcast topics across public show and episode samples with Crawlora Apple Podcasts and Spotify tools. Use for a podcast editorial landscape…
npx skills add github.com/Crawlora-org/crawlora-skills --skill podcast-topic-landscapeResearches music, artists, playlists, and podcasts via the Crawlora API — Spotify tracks/albums/artists/playlists/profiles, Spotify Podcasts, Apple…
npx skills add github.com/Crawlora-org/crawlora-skills --skill music-podcast-researchFAQ
Spotify's Web API exposes shows and episodes you already have ids for, but not the podcast charts, the category browse surfaces, or the home sections. Those come from Spotify's own web client, which is what Crawlora's endpoints read and normalize.
top-podcasts, top-episodes, and trending, plus per-genre charts covering arts, business, comedy, education, fiction, health-fitness, history, leisure, music, news, religion-spirituality, science, society-culture, sports, technology, true-crime, and tv-film. Each takes a two-letter region.
A Spotify uri. Search and chart responses return them, so the normal flow is search or chart first, then pass the uri to the show, episodes, or recommendations endpoint.
Not exactly. On 2026-10-27 the response reported limit 100 and returned 200 items.