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/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/episodes/searchReturns normalized Apple Podcasts episodes from Apple's public iTunes Search API.
| 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. |
| 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 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 |
| Search Apple Podcasts episodes | 1 credit/request | /docs/apple-podcasts/apple-podcasts-episodes-search |
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.