API Reference
Use Crawlora's Apple Podcasts API endpoints to extract supported public ApplePodcasts data as structured JSON. This documentation covers 5 active endpoints including Retrieve Apple Podcasts chart rankings, Search Apple Podcasts episodes, Search Apple Podcasts shows, Retrieve Apple Podcasts show details, 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 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/charts?collection=toppodcasts&category=1303&country=us&limit=50" \
-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/episodes/searchapiKey1 credit/requestReturns normalized Apple Podcasts episodes from Apple's public iTunes Search API.
Required params: term:query
/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
| 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 |
| Search Apple Podcasts episodes | /apple-podcasts/episodes/search | GET | 1 credit/request | term:query | 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 |