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/searchSearches Apple Podcasts shows by `term`, which is required. `country`, `lang`, `limit` and `page` (1-based) refine the search. Each show has `collection_name`, `artist_name`, `feed_url`, `primary_genre_name`, `genres`, `track_count`, `release_date`, content advisory rating and several artwork sizes.
/apple-podcasts/chartsReturns Apple Podcasts show chart rankings for a `collection`, either `toppodcasts` or `topaudiopodcasts`. Narrow with `category` (a numeric Apple podcast genre ID), `country` and `limit`. Each entry has `name`, `artist_name`, `genre`, `genre_id`, `description`, `release_date`, `artwork_url` and `url`.
/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 the details of one Apple Podcasts show by its Apple show `id`: `collection_name`, `artist_name`, `feed_url`, `primary_genre_name`, `genres`, `track_count`, `release_date`, content advisory rating and artwork. `country` and `lang` choose the storefront and language.
/apple-podcasts/show/{id}/episodesReturns one Apple Podcasts show by its Apple show `id`, together with a list of its episodes. `limit` sets how many episodes to return; `country` and `lang` choose the storefront and language. Episodes have `title`, `description`, `duration_millis`, `release_date`, `episode_url` and `episode_guid`.
/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/searchSearches Apple Podcasts episodes by `term`, which is required. `country`, `lang`, `limit` and `page` (1-based) refine the search. Each episode has its `title`, `show_name`, `show_id`, `description`, `duration_millis`, `release_date`, `episode_url`, `preview_url`, `feed_url`, genres and artwork.
/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&limit=10&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.