Descubrimiento de podcasts
Usa los endpoints de Spotify Podcasts para convertir descubrimiento de podcasts en solicitudes API repetibles con inputs documentados y respuestas JSON.
Convierte las páginas de descubrimiento, listas de éxitos, programas y episodios de podcasts de Spotify en datos estructurados para investigación y aplicaciones con agentes.
Recopila la página principal, categorías, listas de éxitos, programas, episodios, recomendaciones y datos de búsqueda de Spotify Podcasts mediante endpoints de API estructurados.
Familias de endpoints
6
Parámetros documentados
42
Ejemplos
8
Snapshot en vivo del catálogo
Endpoints activos
8
Métodos
GET
Parámetros obligatorios
9
Referencias de esquema
8
{
"platform": "Spotify Podcasts",
"endpoint": "spotify-podcasts-categories",
"method": "GET",
"path": "/spotify-podcasts/categories",
"auth": "apiKey"
}Casos de uso relacionados
Casos de uso
Recopila la página principal, categorías, listas de éxitos, programas, episodios, recomendaciones y datos de búsqueda de Spotify Podcasts mediante endpoints de API estructurados.
Usa los endpoints de Spotify Podcasts para convertir descubrimiento de podcasts en solicitudes API repetibles con inputs documentados y respuestas JSON.
Usa los endpoints de Spotify Podcasts para convertir investigación de programas y episodios en solicitudes API repetibles con inputs documentados y respuestas JSON.
Usa los endpoints de Spotify Podcasts para convertir monitoreo de listas de éxitos de podcasts en solicitudes API repetibles con inputs documentados y respuestas JSON.
Ejecución gestionada
Cada cifra de abajo se lee directamente del catálogo de endpoints en vivo de Spotify Podcasts — 8 endpoints, 42 parámetros de solicitud documentados y 8 esquemas de respuesta publicados — el mismo catálogo contra el que corren Docs y Playground.
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.
Mapa de cobertura
Estas tarjetas se generan a partir del catálogo de endpoints activo, así que la landing page refleja la misma superficie de API que usan Docs y Playground.
/spotify-podcasts/show
/spotify-podcasts/categories
/spotify-podcasts/charts
/spotify-podcasts/episode
/spotify-podcasts/home
/spotify-podcasts/search
Catálogo de endpoints
/spotify-podcasts/categoriesReturns normalized Spotify podcast category sections and items from Spotify's all-categories browsePage Pathfinder response.
Notas de la respuesta
- Upstream token, app config, client token, or Pathfinder failures return `503`. - The response uses the same normalized section and item shape as `/api/v1/spotify-podcasts/home`. Example response: ```json { "code": 200, "msg": "OK", "data": { "uri": "spotify:page:0JQ5DArNBzkmxXHCqFLx2U", "title": "All podcast categories", "sections": [ { "uri": "spotify:section:example", "title": "Categories", "items": [ { "uri": "spotify:page:example", "title": "Arts" } ] } ], "meta": { "operationName": "browsePage", "sectionCount": 1, "fetchedAt": "2026-05-13T15:22:41Z" } } } ```
Herramienta MCP spotify_podcasts_categories
/spotify-podcasts/chartsReturns normalized 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.
Notas de la respuesta
- 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. Example response: ```json { "code": 200, "msg": "OK", "data": { "chart": "religion-spirituality", "chartName": "Religion & Spirituality", "chartType": "category", "region": "us", "regionName": "United States", "limit": 100, "items": [ { "rank": 1, "uri": "spotify:show:4Pppt42NPK2XzKwNIoW7BR", "rankMove": "UNCHANGED", "name": "The Bible in a Year (with Fr. Mike Schmitz)", "publisher": "Ascension", "imageUrl": "https://i.scdn.co/image/example", "description": "A podcast description.", "externalUrl": "https://open.spotify.com/show/4Pppt42NPK2XzKwNIoW7BR" } ], "meta": { "sourceUrl": "https://podcastcharts.byspotify.com/api/charts/religion-spirituality?limit=100®ion=us", "count": 1, "fetchedAt": "2026-05-13T15:22:41Z" } } } ```
Herramienta MCP spotify_podcasts_charts
/spotify-podcasts/episodeReturns normalized public episode metadata from Spotify's getEpisodeOrChapter Pathfinder response, with episode page, embed page, and anonymous oEmbed fallbacks when Pathfinder is unavailable. Provide either uri or id; defaults to a known public episode when omitted.
Notas de la respuesta
- Invalid Spotify episode IDs or URLs return `400`. - Pathfinder, upstream page, embed, and oEmbed failures, or parser drift across all sources, 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. Example response: ```json { "code": 200, "msg": "OK", "data": { "uri": "spotify:episode:2C2Y5kNq7qCVOVhbA0G3os", "id": "2C2Y5kNq7qCVOVhbA0G3os", "type": "Episode", "name": "#2496 - Julia Mossbridge", "releaseDate": "2026-05-08T17:00:00Z", "durationMs": 9761982, "isExplicit": true, "isPlayable": true, "playabilityReason": "PLAYABLE", "mediaTypes": ["AUDIO", "VIDEO"], "imageUrl": "https://i.scdn.co/image/example", "videoThumbnailUrl": "https://i.scdn.co/image/video-example", "externalUrl": "https://open.spotify.com/episode/2C2Y5kNq7qCVOVhbA0G3os", "shareUrl": "https://open.spotify.com/episode/2C2Y5kNq7qCVOVhbA0G3os", "previewAudioUrl": "https://audio-preview.spotifycdn.com/example.mp3", "previewAudioUrls": ["https://audio-preview.spotifycdn.com/example.mp3"], "transcriptCount": 1, "show": { "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk", "name": "The Joe Rogan Experience", "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk" }, "meta": { "operationName": "getEpisodeOrChapter", "appVersion": "1.2.90.373.g86862e17", "sourceUrl": "https://api-partner.spotify.com/pathfinder/v2/query", "fetchedAt": "2026-05-13T15:22:41Z" } } } ```
Herramienta MCP spotify_podcasts_episode
/spotify-podcasts/homeReturns normalized sections and items from Spotify's podcast home browsePage Pathfinder response.
Notas de la respuesta
- Upstream token, app config, client token, or Pathfinder failures return `503`. - The response includes normalized section titles, item metadata, image assets, external Spotify URLs, and fetch metadata. Example response: ```json { "code": 200, "msg": "OK", "data": { "uri": "spotify:genre:podcasts-web", "title": "Podcasts", "sections": [ { "uri": "spotify:section:example", "title": "Featured", "items": [ { "uri": "spotify:show:1QQJ7FElLE0K6CIfZNCxU4", "type": "Podcast", "title": "Example Show", "externalUrl": "https://open.spotify.com/show/1QQJ7FElLE0K6CIfZNCxU4" } ] } ], "meta": { "operationName": "browsePage", "sectionCount": 1, "fetchedAt": "2026-05-13T15:22:41Z" } } } ```
Herramienta MCP spotify_podcasts_home
/spotify-podcasts/searchReturns normalized Spotify podcast shows, episodes, and top results for a search term.
Herramienta MCP spotify_podcasts_search
/spotify-podcasts/showReturns normalized podcast show metadata from Spotify Pathfinder.
Herramienta MCP spotify_podcasts_show
/spotify-podcasts/show/episodesReturns normalized podcast episodes for a Spotify show URI.
Herramienta MCP spotify_podcasts_show_episodes
/spotify-podcasts/show/recommendationsReturns normalized related Spotify shows and episodes from Spotify's show recommendations response.
Herramienta MCP spotify_podcasts_show_recommendations
APIs relacionadas
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.
Cómo hacer scraping de Spotify Podcasts
La Web API oficial de Spotify cubre programas y episodios de los que ya tienes un ID, pero no las listas de éxitos de podcasts ni las páginas de exploración renderizadas por su propia app. Los 8 endpoints de Spotify Podcasts de Crawlora devuelven entradas de búsqueda, categorías, página principal y listas de éxitos, metadatos de programas, episodios y recomendaciones como JSON normalizado.
Busca podcasts con el texto libre q, o lee los endpoints de categorías y página principal para obtener las páginas de exploración por secciones que Spotify renderiza en su app.
El endpoint de listas de éxitos acepta valores de chart como top-podcasts, top-episodes o trending, además de listas por género como comedy, news o true-crime, y el código de región documentado de dos letras.
Los endpoints de metadatos de programa y episodios de programa aceptan una uri de Spotify; el detalle de episodio acepta uri o id.
El endpoint de recomendaciones de programa devuelve programas relacionados para una uri — así se construye un mapa de relaciones por tema en lugar de una lista plana.
Preguntas frecuentes
La Web API de Spotify expone programas y episodios de los que ya tienes un ID, pero no las listas de éxitos de podcasts, las páginas de exploración por categoría ni las secciones de la página principal. Esos datos provienen del propio cliente web de Spotify, exactamente lo que los endpoints de Crawlora leen y normalizan.
top-podcasts, top-episodes y trending, además de listas por género que cubren arts, business, comedy, education, fiction, health-fitness, history, leisure, music, news, religion-spirituality, science, society-culture, sports, technology, true-crime y tv-film. Cada una acepta un código de región de dos letras.
Una uri de Spotify. Las respuestas de búsqueda y listas de éxitos la devuelven, así que el flujo habitual es: primero buscar o revisar la lista de éxitos, luego pasar la uri al endpoint de programa, episodio o recomendaciones.