API Reference
Use Crawlora's Apple Podcasts API endpoints to extract supported public ApplePodcasts data as structured JSON. This documentation covers 8 active endpoints including Retrieve Apple Podcasts chart rankings, Retrieve Apple Podcasts chart rankings by algorithm, type, and genre, Search Apple Podcasts episodes, Retrieve Apple Podcasts curated "New" editorial shelves, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as term, id, 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/apple-podcasts/search?country=us&lang=en&limit=10&page=1" \
-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.
/apple-podcasts/chartsapiKey1 credit/requestReturns Apple Podcasts show chart rankings from public iTunes RSS JSON feeds. Supported collections are `toppodcasts` and `topaudiopodcasts`.
Required params: None
/apple-podcasts/charts/rankingsapiKey1 credit/requestReturns Apple Podcasts chart rankings from the modern podcasts.apple.com charts page, covering chart algorithms (`top`, `top-subscriber`, `top-series`) crossed with entity types (`podcasts`, `podcast-episodes`, `podcast-channels`) and an optional genre filter. A richer, differently-sourced capability than the legacy RSS-based `/apple-podcasts/charts` endpoint.
Required params: None
/apple-podcasts/episodes/searchapiKey1 credit/requestReturns normalized Apple Podcasts episodes from Apple's public iTunes Search API.
Required params: term:query
/apple-podcasts/newapiKey1 credit/requestReturns the curated editorial shelves from podcasts.apple.com/{country}/new (New Shows, New Seasons, New Trailers, Essentials, and other seasonal spotlights). Shelves that merely mirror a Charts Rankings query are omitted here since `/apple-podcasts/charts/rankings` already covers that data.
Required params: None
/apple-podcasts/searchapiKey1 credit/requestReturns normalized Apple Podcasts shows from Apple's public iTunes Search API.
Required params: term:query
/apple-podcasts/show/{id}apiKey1 credit/requestReturns normalized show metadata from Apple's public iTunes Lookup API.
Required params: id:path
/apple-podcasts/show/{id}/episodesapiKey1 credit/requestReturns a show and its public Apple Podcasts episodes from Apple's iTunes Lookup API.
Required params: id:path
/apple-podcasts/show/{id}/relatedapiKey1 credit/requestReturns the "You Might Also Like" rail for a single show, sourced from the modern podcasts.apple.com show page's listener-cohort recommendation data.
Required params: id:path
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Retrieve Apple Podcasts chart rankings | /apple-podcasts/charts | GET | 1 credit/request | None | View docs | Try endpoint |
| Retrieve Apple Podcasts chart rankings by algorithm, type, and genre | /apple-podcasts/charts/rankings | GET | 1 credit/request | None | View docs | Try endpoint |
| Search Apple Podcasts episodes | /apple-podcasts/episodes/search | GET | 1 credit/request | term:query | View docs | Try endpoint |
| Retrieve Apple Podcasts curated "New" editorial shelves | /apple-podcasts/new | GET | 1 credit/request | None | View docs | Try endpoint |
| Search Apple Podcasts shows | /apple-podcasts/search | GET | 1 credit/request | term:query | View docs | Try endpoint |
| Retrieve Apple Podcasts show details | /apple-podcasts/show/{id} | GET | 1 credit/request | id:path | View docs | Try endpoint |
| Retrieve Apple Podcasts show episodes | /apple-podcasts/show/{id}/episodes | GET | 1 credit/request | id:path | View docs | Try endpoint |
| Retrieve Apple Podcasts "You Might Also Like" related shows | /apple-podcasts/show/{id}/related | GET | 1 credit/request | id:path | View docs | Try endpoint |