API Reference
Use Crawlora's Spotify Podcasts API endpoints to extract supported public SpotifyPodcasts data as structured JSON. This documentation covers 8 active endpoints including Retrieve Spotify Podcasts categories, Retrieve Spotify podcast charts, Retrieve Spotify podcast episode details, Retrieve Spotify Podcasts home, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and AI-agent workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as q, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/spotify-podcasts/categories?uri=spotify%3Apage%3A0JQ5DArNBzkmxXHCqFLx2U&page_offset=0&page_limit=10§ion_offset=0§ion_limit=10&include_episode_content_ratings_v2=false" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/spotify-podcasts/categoriesapiKey3 credits/requestReturns normalized Spotify podcast category sections and items from Spotify's all-categories browsePage Pathfinder response.
Required params: None
/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.
Required params: None
/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.
Required params: None
/spotify-podcasts/homeapiKey3 credits/requestReturns normalized sections and items from Spotify's podcast home browsePage Pathfinder response.
Required params: None
/spotify-podcasts/searchapiKey3 credits/requestReturns normalized Spotify podcast shows, episodes, and top results for a search term.
Required params: q:query
/spotify-podcasts/showapiKey2 credits/requestReturns normalized podcast show metadata from Spotify Pathfinder.
Required params: None
/spotify-podcasts/show/episodesapiKey3 credits/requestReturns normalized podcast episodes for a Spotify show URI.
Required params: None
/spotify-podcasts/show/recommendationsapiKey2 credits/requestReturns normalized related Spotify shows and episodes from Spotify's show recommendations response.
Required params: None
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Retrieve Spotify Podcasts categories | /spotify-podcasts/categories | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify podcast charts | /spotify-podcasts/charts | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify podcast episode details | /spotify-podcasts/episode | GET | 2 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify Podcasts home | /spotify-podcasts/home | GET | 3 credits/request | None | View docs | Try endpoint |
| Search Spotify Podcasts | /spotify-podcasts/search | GET | 3 credits/request | q:query | View docs | Try endpoint |
| Retrieve Spotify podcast show metadata | /spotify-podcasts/show | GET | 2 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify podcast show episodes | /spotify-podcasts/show/episodes | GET | 3 credits/request | None | View docs | Try endpoint |
| Retrieve Spotify podcast recommendations | /spotify-podcasts/show/recommendations | GET | 2 credits/request | None | View docs | Try endpoint |