播客发现
Use Spotify Podcasts endpoints to turn 播客发现 into repeatable API requests with documented inputs and JSON responses.
将 Spotify 播客的发现页、榜单、节目和单集页面转化为结构化数据，用于研究和智能体应用。
通过结构化 API 端点采集 Spotify Podcasts 的主页、分类、榜单、节目、单集、推荐和搜索数据。
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
通过结构化 API 端点采集 Spotify Podcasts 的主页、分类、榜单、节目、单集、推荐和搜索数据。
Use Spotify Podcasts endpoints to turn 播客发现 into repeatable API requests with documented inputs and JSON responses.
Use Spotify Podcasts endpoints to turn 节目和单集研究 into repeatable API requests with documented inputs and JSON responses.
Use Spotify Podcasts endpoints to turn 播客榜单监控 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`.
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.
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.
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.
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.
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.
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.
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.
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 官方 Web API 覆盖了你已经拥有 ID 的节目和单集，但不覆盖播客榜单或其自有应用渲染的浏览页面。Crawlora 的 8 个 Spotify Podcasts 端点以规范化 JSON 返回搜索、分类、主页及榜单条目、节目元数据、单集和推荐数据。
按自由文本 q 搜索播客，或读取分类和主页端点获取 Spotify 在其应用中渲染的分区浏览页面。
榜单端点接受 chart 参数，如 top-podcasts、top-episodes 或 trending，此外还有按类型划分的榜单，如 comedy、news 或 true-crime，以及文档中列出的两位字母地区代码。
节目元数据和节目单集端点接受 Spotify uri；单集详情接受 uri 或 id。
节目推荐端点会针对某个 uri 返回相关节目，这正是构建一张主题关系图而非一份平铺列表的方式。
客户端库
为你的语言安装 Spotify 专用客户端。每个包都覆盖本页的 Spotify 端点，并使用你的 API 密钥调用 Crawlora 托管 API。
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.ioFAQ
Spotify 的 Web API 暴露了你已经拥有 ID 的节目和单集，但不包括播客榜单、分类浏览页面或主页分区。这些数据来自 Spotify 自己的网页客户端，正是 Crawlora 端点所读取和规范化的内容。
top-podcasts、top-episodes 和 trending，此外还有覆盖 arts、business、comedy、education、fiction、health-fitness、history、leisure、music、news、religion-spirituality、science、society-culture、sports、technology、true-crime 和 tv-film 等类型的榜单。每个都接受一个两位字母的地区代码。
一个 Spotify uri。搜索和榜单响应会返回它，因此常规流程是先搜索或查看榜单，再将 uri 传给节目、单集或推荐端点。