Docs menu

SpotifyPodcasts API endpoint

Spotify Podcasts Charts API

Use Crawlora's Spotify Podcasts Charts API to extract supported public SpotifyPodcasts 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.

GETapiKey3 credits/requestSpotifyPodcastsspotify.chartsResponseDoc/spotify-podcasts/charts

Endpoint facts

Method: GET
API path: /spotify-podcasts/charts
Auth: apiKey
Credits: 3 credits/request
Platform: SpotifyPodcasts
Response schema: #/definitions/spotify.chartsResponseDoc
MCP tool: spotify_podcasts.charts

Overview

Returns normalized Spotify podcast chart rankings from podcastcharts.byspotify.com. The chart and region parameters are validated against Spotify's supported podcast chart slugs and countries. Category charts are available only in au, br, de, gb, mx, se, and us. 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.

Spotify Podcasts platform page Try Spotify Podcasts Charts API in Playground Crawlora API pricing SpotifyPodcasts 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
chart	string	No	Chart slug. Allowed: top-podcasts, top-episodes, trending, arts, business, comedy, education, fiction, health-fitness, history, leisure, music, news, religion-spirituality, science, society-culture, sports, technology, true-crime, tv-film	religion-spirituality
region	string	No	Two-letter region code. Allowed: ar, au, at, br, ca, cl, co, dk, fi, fr, de, in, id, ie, it, jp, mx, nz, no, ph, pl, es, se, nl, gb, us	us
limit	integer	No	Result limit, clamped to 1-100	100
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/spotify-podcasts/charts?chart=religion-spirituality&region=us&limit=100" \
  -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: 3 credits/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: spotify_podcasts.charts
Transport: Streamable HTTP
Docs resource: docs://index

Response behavior

- Invalid `chart` or `region` values return `400`. - `top-podcasts`, `top-episodes`, and `trending` support all listed regions. Category charts support `au`, `br`, `de`, `gb`, `mx`, `se`, and `us`. - `top-episodes` items include episode fields plus the parent show fields when Spotify returns them. - Upstream chart failures return `503`. - `items[].rank` is assigned from the upstream array order. Example response: ```json { "code": 200, "msg": "OK", "data": { "chart": "religion-spirituality", "chartName": "Religion & Spirituality", "chartType": "category", "region": "us", "regionName": "United States", "limit": 100, "items": [ { "rank": 1, "uri": "spotify:show:4Pppt42NPK2XzKwNIoW7BR", "rankMove": "UNCHANGED", "name": "The Bible in a Year (with Fr. Mike Schmitz)", "publisher": "Ascension", "imageUrl": "https://i.scdn.co/image/example", "description": "A podcast description.", "externalUrl": "https://open.spotify.com/show/4Pppt42NPK2XzKwNIoW7BR" } ], "meta": { "sourceUrl": "https://podcastcharts.byspotify.com/api/charts/religion-spirituality?limit=100&region=us", "count": 1, "fetchedAt": "2026-05-13T15:22:41Z" } } } ```

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
429	Rate limit exceeded	#/definitions/app.Response
503	Spotify upstream request failed	#/definitions/app.Response

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "chart": "religion-spirituality",
    "chartName": "Religion & Spirituality",
    "chartType": "category",
    "region": "us",
    "regionName": "United States",
    "limit": 100,
    "items": [
      {
        "rank": 1,
        "uri": "spotify:show:4Pppt42NPK2XzKwNIoW7BR",
        "rankMove": "UNCHANGED",
        "name": "The Bible in a Year (with Fr. Mike Schmitz)",
        "publisher": "Ascension",
        "imageUrl": "https://i.scdn.co/image/example",
        "description": "A podcast description.",
        "externalUrl": "https://open.spotify.com/show/4Pppt42NPK2XzKwNIoW7BR"
      }
    ],
    "meta": {
      "sourceUrl": "https://podcastcharts.byspotify.com/api/charts/religion-spirituality?limit=100&region=us",
      "count": 1,
      "fetchedAt": "2026-05-13T15:22:41Z"
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/spotify.chartsResponseDoc

Field	Type	Required	Example	Description
code	integer	No		Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	spotify.ChartResponse	No
data.chart	string	No	top-podcasts
data.chartName	string	No	Top Podcasts
data.chartType	string	No	chart
data.items	array	No
data.items[].description	string	No	The official podcast of comedian Joe Rogan.
data.items[].episodeDescription	string	No	A representative chart episode.
data.items[].episodeExternalUrl	string	No	https://open.spotify.com/episode/2C2Y5kNq7qCVOVhbA0G3os
data.items[].episodeImageUrl	string	No	https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.items[].episodeName	string	No	Example episode
data.items[].episodeUri	string	No	spotify:episode:2C2Y5kNq7qCVOVhbA0G3os
data.items[].externalUrl	string	No	https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.items[].imageUrl	string	No	https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.items[].name	string	No	The Joe Rogan Experience
data.items[].publisher	string	No	Joe Rogan
data.items[].rank	integer	No	1
data.items[].rankMove	string	No	UNCHANGED
data.items[].showDescription	string	No	The official podcast of comedian Joe Rogan.
data.items[].showExternalUrl	string	No	https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.items[].showImageUrl	string	No	https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.items[].showName	string	No	The Joe Rogan Experience
data.items[].showPublisher	string	No	Joe Rogan
data.items[].showUri	string	No	spotify:show:4rOoJ6Egrf8K2IrywzwOMk
data.items[].uri	string	No	spotify:show:4rOoJ6Egrf8K2IrywzwOMk
data.limit	integer	No	100
data.meta	spotify.ChartMeta	No
data.meta.count	integer	No	100
data.meta.fetchedAt	string	No	2026-05-13T20:41:13Z
data.meta.sourceUrl	string	No	https://podcastcharts.byspotify.com/api/charts/top-podcasts?region=us
data.region	string	No	us
data.regionName	string	No	United States
msg	unknown	No		Msg is the message that describes the result of the request @example "Request successful"

Code examples

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

curl -X GET "https://api.crawlora.net/api/v1/spotify-podcasts/charts?chart=religion-spirituality&region=us&limit=100" \
  -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 SpotifyPodcasts endpoint docs Spotify Podcasts scraper API platform page Crawlora API pricing Try Spotify Podcasts Charts API in Playground Spotify Podcasts Categories API documentation Spotify Podcasts Episode API documentation Spotify Podcasts Home API documentation Spotify Podcasts Search API documentation Spotify Podcasts Show API documentation Spotify Podcasts Show Episodes API documentation

Open in Playground Back to group

Docs menu

SpotifyPodcasts API endpoint

Spotify Podcasts Charts API

GETapiKey3 credits/requestSpotifyPodcastsspotify.chartsResponseDoc/spotify-podcasts/charts

Endpoint facts

Method: GET
API path: /spotify-podcasts/charts
Auth: apiKey
Credits: 3 credits/request
Platform: SpotifyPodcasts
Response schema: #/definitions/spotify.chartsResponseDoc
MCP tool: spotify_podcasts.charts

Overview

Spotify Podcasts platform page Try Spotify Podcasts Charts API in Playground Crawlora API pricing SpotifyPodcasts 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
chart	string	No	Chart slug. Allowed: top-podcasts, top-episodes, trending, arts, business, comedy, education, fiction, health-fitness, history, leisure, music, news, religion-spirituality, science, society-culture, sports, technology, true-crime, tv-film	religion-spirituality
region	string	No	Two-letter region code. Allowed: ar, au, at, br, ca, cl, co, dk, fi, fr, de, in, id, ie, it, jp, mx, nz, no, ph, pl, es, se, nl, gb, us	us
limit	integer	No	Result limit, clamped to 1-100	100
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/spotify-podcasts/charts?chart=religion-spirituality&region=us&limit=100" \
  -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: 3 credits/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: spotify_podcasts.charts
Transport: Streamable HTTP
Docs resource: docs://index

Response behavior

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
429	Rate limit exceeded	#/definitions/app.Response
503	Spotify upstream request failed	#/definitions/app.Response

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "chart": "religion-spirituality",
    "chartName": "Religion & Spirituality",
    "chartType": "category",
    "region": "us",
    "regionName": "United States",
    "limit": 100,
    "items": [
      {
        "rank": 1,
        "uri": "spotify:show:4Pppt42NPK2XzKwNIoW7BR",
        "rankMove": "UNCHANGED",
        "name": "The Bible in a Year (with Fr. Mike Schmitz)",
        "publisher": "Ascension",
        "imageUrl": "https://i.scdn.co/image/example",
        "description": "A podcast description.",
        "externalUrl": "https://open.spotify.com/show/4Pppt42NPK2XzKwNIoW7BR"
      }
    ],
    "meta": {
      "sourceUrl": "https://podcastcharts.byspotify.com/api/charts/religion-spirituality?limit=100&region=us",
      "count": 1,
      "fetchedAt": "2026-05-13T15:22:41Z"
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/spotify.chartsResponseDoc

Field	Type	Required	Example	Description
code	integer	No		Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	spotify.ChartResponse	No
data.chart	string	No	top-podcasts
data.chartName	string	No	Top Podcasts
data.chartType	string	No	chart
data.items	array	No
data.items[].description	string	No	The official podcast of comedian Joe Rogan.
data.items[].episodeDescription	string	No	A representative chart episode.
data.items[].episodeExternalUrl	string	No	https://open.spotify.com/episode/2C2Y5kNq7qCVOVhbA0G3os
data.items[].episodeImageUrl	string	No	https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.items[].episodeName	string	No	Example episode
data.items[].episodeUri	string	No	spotify:episode:2C2Y5kNq7qCVOVhbA0G3os
data.items[].externalUrl	string	No	https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.items[].imageUrl	string	No	https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.items[].name	string	No	The Joe Rogan Experience
data.items[].publisher	string	No	Joe Rogan
data.items[].rank	integer	No	1
data.items[].rankMove	string	No	UNCHANGED
data.items[].showDescription	string	No	The official podcast of comedian Joe Rogan.
data.items[].showExternalUrl	string	No	https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk
data.items[].showImageUrl	string	No	https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b
data.items[].showName	string	No	The Joe Rogan Experience
data.items[].showPublisher	string	No	Joe Rogan
data.items[].showUri	string	No	spotify:show:4rOoJ6Egrf8K2IrywzwOMk
data.items[].uri	string	No	spotify:show:4rOoJ6Egrf8K2IrywzwOMk
data.limit	integer	No	100
data.meta	spotify.ChartMeta	No
data.meta.count	integer	No	100
data.meta.fetchedAt	string	No	2026-05-13T20:41:13Z
data.meta.sourceUrl	string	No	https://podcastcharts.byspotify.com/api/charts/top-podcasts?region=us
data.region	string	No	us
data.regionName	string	No	United States
msg	unknown	No		Msg is the message that describes the result of the request @example "Request successful"

Code examples

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

curl -X GET "https://api.crawlora.net/api/v1/spotify-podcasts/charts?chart=religion-spirituality&region=us&limit=100" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Responsible public web data workflows

Read Crawlora terms

Open in Playground Back to group

Spotify Podcasts Charts API

Endpoint facts

Overview

Request parameters

cURL example

Authentication

Billing

Infrastructure behavior

MCP

Response behavior

Error behavior

Failure responses

Example JSON response

Code examples

Responsible public web data workflows

Related

Spotify Podcasts Charts API

Endpoint facts

Overview

Request parameters

cURL example

Authentication

Billing

Infrastructure behavior

MCP

Response behavior

Error behavior

Failure responses

Example JSON response

Code examples

Responsible public web data workflows

Related