API Reference
8 SpotifyPodcasts API endpoints for web scraping workflows, with REST paths, authentication requirements, parameters, examples, and MCP tool metadata where supported.
/spotify-podcasts/categoriesapiKey3 credits/requestReturns normalized Spotify podcast category sections and items from Spotify's all-categories browsePage Pathfinder response.
Params: uri:query, page_offset:query, page_limit:query, section_offset:query, section_limit:query, include_episode_content_ratings_v2:query, x-api-key:header
/spotify-podcasts/chartsapiKey3 credits/requestReturns 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.
Params: chart:query, region:query, limit:query, x-api-key:header
/spotify-podcasts/episodeapiKey2 credits/requestReturns 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.
Params: uri:query, id:query, x-api-key:header
/spotify-podcasts/homeapiKey3 credits/requestReturns normalized sections and items from Spotify's podcast home browsePage Pathfinder response.
Params: uri:query, page_offset:query, page_limit:query, section_offset:query, section_limit:query, include_episode_content_ratings_v2:query, x-api-key:header
/spotify-podcasts/searchapiKey3 credits/requestReturns normalized Spotify podcast shows, episodes, and top results for a search term.
Params: q:query, offset:query, limit:query, number_of_top_results:query, include_pre_releases:query, include_album_pre_releases:query, include_audiobooks:query, include_authors:query, include_episode_content_ratings_v2:query, x-api-key:header
/spotify-podcasts/showapiKey2 credits/requestReturns normalized podcast show metadata from Spotify Pathfinder.
Params: uri:query, include_content_capability_trait:query, include_episode_content_ratings_v2:query, x-api-key:header
/spotify-podcasts/show/episodesapiKey3 credits/requestReturns normalized podcast episodes for a Spotify show URI.
Params: uri:query, offset:query, limit:query, include_episode_content_ratings_v2:query, x-api-key:header
/spotify-podcasts/show/recommendationsapiKey2 credits/requestReturns normalized related Spotify shows and episodes from Spotify's show recommendations response.
Params: uri:query, x-api-key:header