GETApplePodcastsapiKey1 credit/request
Search Apple Podcasts shows
/apple-podcasts/searchReturns normalized Apple Podcasts shows from Apple's public iTunes Search API.
Crawlora Docs
Search Apple Podcasts shows, enrich show and episode metadata, and track chart rankings by country and category as structured JSON.
Search Apple Podcasts shows, enrich show and episode metadata, and track chart rankings by country and category as structured JSON.
Only endpoints that exist in the generated endpoint metadata are linked here. Missing optional endpoints are intentionally omitted.
/apple-podcasts/searchReturns normalized Apple Podcasts shows from Apple's public iTunes Search API.
/apple-podcasts/chartsReturns Apple Podcasts show chart rankings from public iTunes RSS JSON feeds. Supported collections are `toppodcasts` and `topaudiopodcasts`.
/apple-podcasts/charts/rankingsReturns 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.
/apple-podcasts/show/{id}Returns normalized show metadata from Apple's public iTunes Lookup API.
/apple-podcasts/show/{id}/episodesReturns a show and its public Apple Podcasts episodes from Apple's iTunes Lookup API.
/apple-podcasts/show/{id}/relatedReturns the "You Might Also Like" rail for a single show, sourced from the modern podcasts.apple.com show page's listener-cohort recommendation data.
/apple-podcasts/episodes/searchReturns normalized Apple Podcasts episodes from Apple's public iTunes Search API.
/apple-podcasts/newReturns 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.
| Field | Notes |
|---|---|
| term | Workflow field; map to exact endpoint response fields from endpoint docs. |
| country | Workflow field; map to exact endpoint response fields from endpoint docs. |
| category | Workflow field; map to exact endpoint response fields from endpoint docs. |
| show_id | Workflow field; map to exact endpoint response fields from endpoint docs. |
| show_name | Workflow field; map to exact endpoint response fields from endpoint docs. |
| feed_url | Workflow field; map to exact endpoint response fields from endpoint docs. |
| genres | Workflow field; map to exact endpoint response fields from endpoint docs. |
| episode_title | Workflow field; map to exact endpoint response fields from endpoint docs. |
| publish_date | Workflow field; map to exact endpoint response fields from endpoint docs. |
| duration | Workflow field; map to exact endpoint response fields from endpoint docs. |
| chart_rank | Workflow field; map to exact endpoint response fields from endpoint docs. |
| chart | Workflow field; map to exact endpoint response fields from endpoint docs. |
| type | Workflow field; map to exact endpoint response fields from endpoint docs. |
| related_show_id | Workflow field; map to exact endpoint response fields from endpoint docs. |
| shelf_title | Workflow field; map to exact endpoint response fields from endpoint docs. |
| checked_at | Workflow field; map to exact endpoint response fields from endpoint docs. |
| request_id | Workflow field; map to exact endpoint response fields from endpoint docs. |
| credits_used | Include when response or usage data makes it available. |
This example uses the real Search Apple Podcasts shows endpoint. Exact request fields come from the endpoint metadata.
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/apple-podcasts/search?term=hardcore+history&country=us&lang=en-us&limit=50&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"Use endpoint detail pages for exact response schemas. This recipe does not invent response fields.
{
"code": 200,
"msg": "OK",
"data": [
{
"id": 173001861,
"artist_name": "Dan Carlin",
"collection_name": "Dan Carlin's Hardcore History",
"track_name": "Dan Carlin's Hardcore History",
"url": "https://podcasts.apple.com/us/podcast/dan-carlins-hardcore-history/id173001861?uo=4",
"feed_url": "https://feeds.feedburner.com/dancarlin/history?format=xml",
"primary_genre_name": "History"
}
]
}Store one row per show, episode, and chart check so chart positions and catalog changes can be compared over time.
Estimate usage by multiplying requests by endpoint credit cost. The table below only shows real credit costs available from the billing constants.
| Endpoint | Credit cost | Docs |
|---|---|---|
| Search Apple Podcasts shows | 1 credit/request | /docs/apple-podcasts/apple-podcasts-search |
| Retrieve Apple Podcasts chart rankings | 1 credit/request | /docs/apple-podcasts/apple-podcasts-charts |
| Retrieve Apple Podcasts chart rankings by algorithm, type, and genre | 1 credit/request | /docs/apple-podcasts/apple-podcasts-charts-rankings |
| Retrieve Apple Podcasts show details | 1 credit/request | /docs/apple-podcasts/apple-podcasts-show |
| Retrieve Apple Podcasts show episodes | 1 credit/request | /docs/apple-podcasts/apple-podcasts-show-episodes |
| Retrieve Apple Podcasts "You Might Also Like" related shows | 1 credit/request | /docs/apple-podcasts/apple-podcasts-show-related |
| Search Apple Podcasts episodes | 1 credit/request | /docs/apple-podcasts/apple-podcasts-episodes-search |
| Retrieve Apple Podcasts curated "New" editorial shelves | 1 credit/request | /docs/apple-podcasts/apple-podcasts-new |
Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.
Read Crawlora termsUse this recipe for workflow shape, then rely on endpoint reference pages for exact paths, request schemas, response schemas, and credit costs.