Docs menu

ApplePodcasts API endpoint

Apple Podcasts Show Episodes API

Use Crawlora's Apple Podcasts Show Episodes API to extract supported public ApplePodcasts data as structured JSON. This page includes request parameters, cURL examples, response schema, error behavior, credit cost, and a Playground link for testing before integration.

GETapiKey1 credit/requestApplePodcastsapplepodcasts.showEpisodesResponseDoc/apple-podcasts/show/{id}/episodes

Endpoint facts

Method: GET
API path: /apple-podcasts/show/{id}/episodes
Auth: apiKey
Credits: 1 credit/request
Platform: ApplePodcasts
Response schema: #/definitions/applepodcasts.showEpisodesResponseDoc
MCP tool: apple_podcasts.show_episodes

Overview

Returns a show and its public Apple Podcasts episodes from Apple's iTunes Lookup API. Developers commonly use this endpoint for data enrichment, monitoring, research dashboards, internal automation, and AI-agent workflows that need repeatable structured public web data. Authentication uses the documented Crawlora headers, and usage is metered with the credit cost shown on this page.

Apple Podcasts platform page Try Apple Podcasts Show Episodes API in Playground Crawlora API pricing ApplePodcasts API documentation

Request parameters

Request parameters are generated from the active endpoint catalog. Required values must be sent before Crawlora can call the upstream public web data source.

Parameter	Type	Required	Description	Example
id (path)	string	Yes	Apple Podcasts show ID	173001861
country	string	No	Two-letter storefront country code	us
lang	string	No	Result language tag	en-us
limit	integer	No	Number of episodes to return	50
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/apple-podcasts/show/173001861/episodes?country=us&lang=en-us&limit=50" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost: 1 credit/request
Charged response: Successful 2xx responses

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Infrastructure behavior

This endpoint is executed through Crawlora's managed scraping infrastructure.

Proxy strategy: managed automatically where needed
Browser rendering: enabled for supported targets that require rendered HTML or JavaScript execution
Browser cluster: supported dynamic workloads can be routed through distributed browser instances
Retry behavior: automatic retry/fallback may be used depending on endpoint type
Challenge handling: challenged pages or unusable upstream HTML are detected and surfaced clearly when they cannot be used
Billing: credits are charged only for successful 2xx responses
Observability: responses include request context where available

MCP

MCP URL: https://mcp.crawlora.net/mcp
Tool name: apple_podcasts.show_episodes
Transport: Streamable HTTP
Docs resource: docs://index

Error behavior

Crawlora does not silently return bad data when the upstream page cannot be used.

Status	Common failure case
400	Invalid input or missing required parameter
429	Plan or endpoint rate limit exceeded
500	Internal execution error
502	Upstream platform failed, returned unusable HTML, or served a challenge page that could not be resolved

When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.

Failure responses

Status	Description	Schema
400	Missing or invalid parameters	#/definitions/app.Response
404	Show not found	#/definitions/app.Response
429	Rate limit exceeded	#/definitions/app.Response
500	Internal server error	#/definitions/app.Response

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "show": {
      "id": 173001861,
      "collection_name": "Dan Carlin's Hardcore History"
    },
    "episodes": [
      {
        "id": 1000742374669,
        "show_id": 173001861,
        "title": "Mania for Subjugation III",
        "duration_millis": 15253000
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/applepodcasts.showEpisodesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	applepodcasts.ShowEpisodesResult	No
data.episodes	array	No
data.episodes[].artwork_url_160	string	No
data.episodes[].artwork_url_60	string	No
data.episodes[].artwork_url_600	string	No
data.episodes[].closed_captioning	string	No
data.episodes[].content_advisory_rating	string	No
data.episodes[].country	string	No
data.episodes[].description	string	No
data.episodes[].duration_millis	integer	No
data.episodes[].episode_content_type	string	No
data.episodes[].episode_file_extension	string	No
data.episodes[].episode_guid	string	No
data.episodes[].episode_url	string	No
data.episodes[].feed_url	string	No
data.episodes[].genres	array	No
data.episodes[].genres[].id	string	No
data.episodes[].genres[].name	string	No
data.episodes[].id	integer	No
data.episodes[].preview_url	string	No
data.episodes[].release_date	string	No
data.episodes[].short_description	string	No
data.episodes[].show_id	integer	No
data.episodes[].show_name	string	No
data.episodes[].show_url	string	No
data.episodes[].title	string	No
data.episodes[].url	string	No
data.show	applepodcasts.PodcastShow	No
data.show.artist_id	integer	No
data.show.artist_name	string	No
data.show.artist_url	string	No
data.show.artwork_url_100	string	No
data.show.artwork_url_30	string	No
data.show.artwork_url_60	string	No
data.show.artwork_url_600	string	No
data.show.collection_explicitness	string	No
data.show.collection_name	string	No
data.show.content_advisory_rating	string	No
data.show.country	string	No
data.show.currency	string	No
data.show.feed_url	string	No
data.show.genre_ids	array	No
data.show.genres	array	No
data.show.id	integer	No
data.show.primary_genre_name	string	No
data.show.release_date	string	No
data.show.track_count	integer	No
data.show.track_explicitness	string	No
data.show.track_name	string	No
data.show.url	string	No
msg	string	No	OK

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/apple-podcasts/show/173001861/episodes?country=us&lang=en-us&limit=50" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Responsible public web data workflows

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 terms

More ApplePodcasts endpoint docs Apple Podcasts scraper API platform page Crawlora API pricing Try Apple Podcasts Show Episodes API in Playground Apple Podcasts Charts API documentation Apple Podcasts Episodes Search API documentation Apple Podcasts Search API documentation Apple Podcasts Show API documentation

Open in Playground Back to group

Docs menu

ApplePodcasts API endpoint

Apple Podcasts Show Episodes API

GETapiKey1 credit/requestApplePodcastsapplepodcasts.showEpisodesResponseDoc/apple-podcasts/show/{id}/episodes

Endpoint facts

Method: GET
API path: /apple-podcasts/show/{id}/episodes
Auth: apiKey
Credits: 1 credit/request
Platform: ApplePodcasts
Response schema: #/definitions/applepodcasts.showEpisodesResponseDoc
MCP tool: apple_podcasts.show_episodes

Overview

Apple Podcasts platform page Try Apple Podcasts Show Episodes API in Playground Crawlora API pricing ApplePodcasts API documentation

Request parameters

Request parameters are generated from the active endpoint catalog. Required values must be sent before Crawlora can call the upstream public web data source.

Parameter	Type	Required	Description	Example
id (path)	string	Yes	Apple Podcasts show ID	173001861
country	string	No	Two-letter storefront country code	us
lang	string	No	Result language tag	en-us
limit	integer	No	Number of episodes to return	50
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/apple-podcasts/show/173001861/episodes?country=us&lang=en-us&limit=50" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost: 1 credit/request
Charged response: Successful 2xx responses

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Infrastructure behavior

This endpoint is executed through Crawlora's managed scraping infrastructure.

Proxy strategy: managed automatically where needed
Browser rendering: enabled for supported targets that require rendered HTML or JavaScript execution
Browser cluster: supported dynamic workloads can be routed through distributed browser instances
Retry behavior: automatic retry/fallback may be used depending on endpoint type
Challenge handling: challenged pages or unusable upstream HTML are detected and surfaced clearly when they cannot be used
Billing: credits are charged only for successful 2xx responses
Observability: responses include request context where available

MCP

MCP URL: https://mcp.crawlora.net/mcp
Tool name: apple_podcasts.show_episodes
Transport: Streamable HTTP
Docs resource: docs://index

Error behavior

Crawlora does not silently return bad data when the upstream page cannot be used.

Status	Common failure case
400	Invalid input or missing required parameter
429	Plan or endpoint rate limit exceeded
500	Internal execution error
502	Upstream platform failed, returned unusable HTML, or served a challenge page that could not be resolved

When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.

Failure responses

Status	Description	Schema
400	Missing or invalid parameters	#/definitions/app.Response
404	Show not found	#/definitions/app.Response
429	Rate limit exceeded	#/definitions/app.Response
500	Internal server error	#/definitions/app.Response

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "show": {
      "id": 173001861,
      "collection_name": "Dan Carlin's Hardcore History"
    },
    "episodes": [
      {
        "id": 1000742374669,
        "show_id": 173001861,
        "title": "Mania for Subjugation III",
        "duration_millis": 15253000
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/applepodcasts.showEpisodesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	applepodcasts.ShowEpisodesResult	No
data.episodes	array	No
data.episodes[].artwork_url_160	string	No
data.episodes[].artwork_url_60	string	No
data.episodes[].artwork_url_600	string	No
data.episodes[].closed_captioning	string	No
data.episodes[].content_advisory_rating	string	No
data.episodes[].country	string	No
data.episodes[].description	string	No
data.episodes[].duration_millis	integer	No
data.episodes[].episode_content_type	string	No
data.episodes[].episode_file_extension	string	No
data.episodes[].episode_guid	string	No
data.episodes[].episode_url	string	No
data.episodes[].feed_url	string	No
data.episodes[].genres	array	No
data.episodes[].genres[].id	string	No
data.episodes[].genres[].name	string	No
data.episodes[].id	integer	No
data.episodes[].preview_url	string	No
data.episodes[].release_date	string	No
data.episodes[].short_description	string	No
data.episodes[].show_id	integer	No
data.episodes[].show_name	string	No
data.episodes[].show_url	string	No
data.episodes[].title	string	No
data.episodes[].url	string	No
data.show	applepodcasts.PodcastShow	No
data.show.artist_id	integer	No
data.show.artist_name	string	No
data.show.artist_url	string	No
data.show.artwork_url_100	string	No
data.show.artwork_url_30	string	No
data.show.artwork_url_60	string	No
data.show.artwork_url_600	string	No
data.show.collection_explicitness	string	No
data.show.collection_name	string	No
data.show.content_advisory_rating	string	No
data.show.country	string	No
data.show.currency	string	No
data.show.feed_url	string	No
data.show.genre_ids	array	No
data.show.genres	array	No
data.show.id	integer	No
data.show.primary_genre_name	string	No
data.show.release_date	string	No
data.show.track_count	integer	No
data.show.track_explicitness	string	No
data.show.track_name	string	No
data.show.url	string	No
msg	string	No	OK

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/apple-podcasts/show/173001861/episodes?country=us&lang=en-us&limit=50" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Responsible public web data workflows

Read Crawlora terms

Open in Playground Back to group

Apple Podcasts Show Episodes API

Endpoint facts

Overview

Request parameters

cURL example

Authentication

Billing

Infrastructure behavior

MCP

Error behavior

Failure responses

Example JSON response

Code examples

Responsible public web data workflows

Related

Apple Podcasts Show Episodes API

Endpoint facts

Overview

Request parameters

cURL example

Authentication

Billing

Infrastructure behavior

MCP

Error behavior

Failure responses

Example JSON response

Code examples

Responsible public web data workflows

Related