Spotify Podcast Charts Scraper avatar

Spotify Podcast Charts Scraper

Pricing

from $0.03 / 1,000 item extracteds

Go to Apify Store
Spotify Podcast Charts Scraper

Spotify Podcast Charts Scraper

Export Spotify podcast charts: Top Podcasts, Trending, Top Episodes and 17 genre charts in 26 countries, with rank, movement, show and episode details. No login, browser or proxy.

Pricing

from $0.03 / 1,000 item extracteds

Rating

0.0

(0)

Developer

Automation Lab

Automation Lab

Maintained by Community

Actor stats

0

Bookmarked

14

Total users

4

Monthly active users

2 days ago

Last modified

Categories

Features

Limited permissionsMulti-tenantServer interface

Share

Export Spotify's current public podcast rankings by country and chart as clean JSON: Top Podcasts, Trending Podcasts, Top Episodes and 17 genre charts in 26 markets.

Collect Top Podcasts, Trending Podcasts, Top Episodes, and supported genre charts without a Spotify login, API key, browser, or proxy. Each dataset row is one ranked show (or, on Top Episodes, one ranked episode with its show) with its rank, movement, publisher, description, artwork, Spotify identifiers, market, chart, and observation time. Need one chart instantly from your own app? Call the Server API instead of starting a run.

What this Actor does

Spotify Podcast Charts Scraper turns the public charts on podcastcharts.byspotify.com into integration-ready records.

It can:

  • collect one or many Spotify markets in one run;
  • export Top Podcasts and Trending Podcasts in 26 supported markets;
  • export Top Episodes (the 200 most-played episodes, with episode title, link, description and artwork) in all 26 markets;
  • export 17 genre charts in the seven markets where Spotify offers them;
  • limit results independently for every market/chart pair;
  • preserve chart order as a one-based rank;
  • expose Spotify's rank-movement label;
  • add the original source object when auditability is useful;
  • run efficiently over anonymous JSON instead of a browser.

Use scheduled Apify runs to build daily or weekly rank history. The Actor returns a current snapshot; it does not invent historical ranks that Spotify does not expose.

Who is it for

Podcast networks monitor titles across markets and genres.

Talent scouts identify rising shows from Trending Podcasts.

Sponsorship teams build prospect lists from ranked podcasts and publishers.

Agencies automate recurring client rank reports.

Creators compare their category position with competitors.

Media researchers create reproducible snapshots for market analysis.

Data teams feed rankings into warehouses, dashboards, alerts, and notebooks.

Why use this Actor

  • Focused workflow: podcast rankings rather than general Spotify entity scraping.
  • Current market matrix: invalid genre/region combinations fail clearly instead of silently yielding no data.
  • Typed output: stable fields are ready for datasets and integrations.
  • Low overhead: direct HTTP requests, 256 MB memory, and no image downloads.
  • Repeatable snapshots: every row includes observedAt, region, and chart.
  • Defensive extraction: bounded retries, content-type checks, payload-shape checks, and row validation.

Supported markets

Top Podcasts, Trending Podcasts, and Top Episodes are supported in:

us, ar, au, at, br, ca, cl, co, dk, fi, fr, de, in, id, ie, it, jp, mx, nz, no, ph, pl, es, se, nl, and gb.

Genre charts are currently available only in:

us, au, br, de, mx, se, and gb.

Spotify can change this public catalog. The Actor validates against the catalog verified for this release.

Supported charts

Universal charts:

  • top-podcasts
  • trending
  • top-episodes (ranked episodes; adds the episode* fields)

Genre charts:

  • arts
  • business
  • comedy
  • education
  • fiction
  • health-fitness
  • history
  • leisure
  • music
  • news
  • religion-spirituality
  • science
  • society-culture
  • sports
  • technology
  • true-crime
  • tv-film

Quick start

  1. Open the Actor input.
  2. Select one or more Regions.
  3. Select one or more Charts.
  4. Set Maximum shows per chart.
  5. Leave raw data disabled unless you need the source object.
  6. Click Start.
  7. Open Dataset → Podcast rankings when the run succeeds.
  8. Export JSON, CSV, Excel, XML, or RSS from Apify.

A safe first run is:

{
"regions": ["us"],
"charts": ["top-podcasts", "trending"],
"maxItemsPerChart": 20,
"includeRawData": false
}

Input parameters

FieldTypeDefaultDescription
regionsstring[]["us"]Spotify two-letter market codes to collect.
chartsstring[]["top-podcasts"]Ranking lists to collect in every selected region.
maxItemsPerChartinteger100Maximum rows per region/chart pair, from 1 to 200.
includeRawDatabooleanfalseInclude Spotify's original chart object as rawData.

The Actor removes duplicate region and chart values. Input values are normalized to lowercase. Unsupported values fail before any request is made. A genre chart paired with an unsupported market also fails before collection.

Output fields

FieldTypeMeaning
rankintegerOne-based position in this chart snapshot.
showUristringSpotify URI, such as spotify:show:....
showIdstringID extracted from the Spotify URI.
showUrlstringPublic Spotify show URL.
showNamestringPodcast title.
publisherstring or nullPublisher/creator supplied by Spotify.
descriptionstring or nullCurrent Spotify show description.
artworkUrlstring or nullSpotify artwork URL; the image is not downloaded.
chartRankMovestring or nullUsually UP, DOWN, or UNCHANGED.
episodeUristring or nullSpotify episode URI on the Top Episodes chart; null on show charts.
episodeIdstring or nullEpisode ID from the URI (Top Episodes only).
episodeUrlstring or nullPublic Spotify episode URL (Top Episodes only).
episodeNamestring or nullEpisode title (Top Episodes only).
episodeDescriptionstring or nullEpisode show notes (Top Episodes only).
episodeArtworkUrlstring or nullEpisode artwork URL (Top Episodes only).
regionstringRequested Spotify market code.
chartstringRequested chart identifier.
observedAtISO timestampUTC observation time shared by this run.
sourceUrlstringCorresponding public Spotify chart page.
rawDataobject, optionalOriginal source row when enabled.

Example output

{
"rank": 1,
"showUri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk",
"showId": "4rOoJ6Egrf8K2IrywzwOMk",
"showUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
"showName": "The Joe Rogan Experience",
"publisher": "Joe Rogan",
"description": "The official podcast of comedian Joe Rogan.",
"artworkUrl": "https://i.scdn.co/image/ab67656300005f1f2e7936ee02774abeceb710f2",
"chartRankMove": "UNCHANGED",
"region": "us",
"chart": "top-podcasts",
"observedAt": "2026-07-25T03:50:35.053Z",
"sourceUrl": "https://podcastcharts.byspotify.com/us/top-podcasts"
}

This example came from current public output during local validation. Rankings and descriptions naturally change over time.

Limits and data behavior

Spotify currently returns up to 200 rows for Top Podcasts, Trending Podcasts, and Top Episodes. Genre charts currently return up to 50 rows. maxItemsPerChart is a local output limit because Spotify may ignore the API limit parameter.

The maximum applies to every selected pair. For example, two regions × three charts × 20 items can produce up to 120 rows. Naturally shorter charts produce fewer rows. The run's status message says how many rows were saved against the limit and why, for example Got 250 of 300 rows: Spotify publishes fewer shows on some charts (us/comedy lists 50). If one chart fails after retries, rows from the other charts are kept and the status names the failure.

The Actor does not fetch full episode lists, reviews, audio, listening counts, or private audience analytics. It does not resolve a show's historical rank. Schedule runs and retain datasets if you need history.

How much does it cost to scrape Spotify podcast charts?

This Actor uses pay-per-event pricing: $0.001 per run started, plus a plan-based price for every dataset item. Invalid input and runs that fail before saving anything are not charged.

Apify plan tierPrice per dataset item
Free$0.000048731
Bronze$0.000042375
Silver$0.000033052
Gold$0.000025425
Platinum$0.00001695
Diamond$0.000011865

Price update from December 5, 2026: the per-item price moves to Apify's standard plan curve: Free and Bronze $0.000042375, Silver $0.000038138, Gold, Platinum and Diamond $0.0000339. The $0.001 start fee is unchanged.

The Apify Console displays your active event prices before a run. Set a maximum total charge in Apify when you need a hard budget cap. Final cost depends mainly on the number of selected region/chart pairs and the rows each chart contains.

At the highest (Free-tier) item price, example Actor charges are:

  • US Top Podcasts capped at 20: up to $0.001975;
  • US Top + Trending capped at 100 each: up to $0.010747;
  • three markets and two genre charts capped at 50 each: up to $0.015620.

Paid Apify tiers cost less per item. These are Actor event charges and exclude any separate post-run storage operations billed by Apify.

Build a rank history

Create a daily or weekly schedule with fixed input. Store each run's dataset or merge rows into your warehouse. Use (observedAt, region, chart, showUri) as a snapshot key. Compare rank between snapshots for numeric movement. Spotify's chartRankMove is the source label, not a numeric delta.

A monitoring workflow can:

  1. run every morning;
  2. export rows to BigQuery, Snowflake, Sheets, or S3;
  3. compare each show with its prior snapshot;
  4. alert when a show enters the top 20;
  5. publish a dashboard by market and genre.

Sponsorship and talent discovery

Use Trending Podcasts to find newly visible shows. Join showUri or showId across snapshots to measure persistence. Group by publisher to find networks with several ranked titles. Use descriptions for classification, while reviewing results manually before outreach.

Chart rank is not the same as downloads, revenue, reach, or audience demographics. Do not present it as those metrics.

API usage with cURL

Start a run and wait for its dataset:

curl "https://api.apify.com/v2/acts/automation-lab~spotify-podcast-charts-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-X POST \
-H "Content-Type: application/json" \
-d '{"regions":["us"],"charts":["top-podcasts"],"maxItemsPerChart":20}'

Keep tokens in environment variables or a secret manager. Do not commit them to source control.

JavaScript API example

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('automation-lab/spotify-podcast-charts-scraper').call({
regions: ['us', 'gb'],
charts: ['trending'],
maxItemsPerChart: 50,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Install the client with npm install apify-client.

Python API example

import os
from apify_client import ApifyClient
client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('automation-lab/spotify-podcast-charts-scraper').call(run_input={
'regions': ['us', 'gb', 'au'],
'charts': ['comedy'],
'maxItemsPerChart': 50,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

Install the client with pip install apify-client.

Webhooks and integrations

Attach an Apify webhook to ACTOR.RUN.SUCCEEDED to trigger your pipeline. Common destinations include Make, Zapier, Slack, Google Sheets, Airbyte, Keboola, and custom HTTP services.

For production workflows:

  • pin your input in an Apify Task;
  • schedule the Task rather than duplicating input;
  • store the run ID with each imported batch;
  • alert on failed runs;
  • deduplicate on region, chart, show URI, and observation time.

MCP setup

Use the Apify MCP server to run this Actor from an AI client.

Claude Code:

claude mcp add --transport http apify \
"https://mcp.apify.com?tools=automation-lab/spotify-podcast-charts-scraper"

Claude Desktop, Cursor, and VS Code MCP configuration:

{
"mcpServers": {
"apify": {
"url": "https://mcp.apify.com?tools=automation-lab/spotify-podcast-charts-scraper"
}
}
}

Example prompts:

  • "Run Spotify Podcast Charts Scraper for the US top-podcasts chart and return 20 shows."
  • "Collect comedy podcast charts in the US, UK, and Australia, then compare publishers."
  • "Fetch US Trending Podcasts and summarize shows that would fit a technology sponsor."
  • "Get the top 20 Spotify podcast episodes in Japan this week with their episode links."

Review generated interpretations against the original dataset.

Troubleshooting

Why did the run reject my region/chart combination?

Spotify offers genre charts only in US, AU, BR, DE, MX, SE, and GB. Use top-podcasts or trending for other supported regions.

Why did I receive fewer rows than requested?

The source chart may contain fewer entries. Genre charts currently expose up to 50 rows. The Actor never duplicates rows to fill a requested limit.

Why did a run fail after retries?

Spotify may be temporarily unavailable, rate limiting, or changing its response. Inspect the run log for the affected region and chart, then retry later. Persistent shape errors require an Actor update rather than repeated runs.

Why is rawData missing?

Set includeRawData to true. Normalized fields remain the recommended stable integration contract.

Legality and responsible use

This Actor accesses public chart data without authentication. You are responsible for complying with Spotify's terms, Apify's terms, and applicable law. Use reasonable schedules and avoid unnecessary repeated collection.

Podcast descriptions and publisher names can contain personal or copyrighted material. Store and process them only for a lawful purpose. Do not use chart position alone for automated high-impact decisions. Do not imply endorsement by Spotify or by any listed podcast.

This Actor is an independent automation tool and is not affiliated with Spotify.

Choose this Actor when the primary entity is a podcast chart position. Choose the related Actors when you need broader metadata, episode discovery, or music charts.

FAQ

Does it need my Spotify account?

No. The current public chart JSON is anonymous.

Does it use a browser or proxy?

No. The Actor uses direct HTTP requests and does not download artwork files.

Are rankings real time?

They are current at the time Spotify serves the chart, but Spotify controls refresh timing. observedAt records when the Actor fetched the data, not when Spotify recalculated it.

Can I collect every market and category?

Yes for valid combinations, but genre charts are limited to seven markets. Large matrix runs create one request per market/chart pair and more item charges.

Can I get historical rankings?

The source provides a current snapshot. Schedule the Actor and retain results to create your own history.

Can I use the data commercially?

Public availability does not automatically grant every use. Assess your use case, applicable terms, and legal obligations.

What happens if Spotify changes the route?

The Actor validates response status, content type, and record shape and fails clearly rather than returning misleading empty success. Report persistent failures with the run URL and non-secret input.

Support

For a reproducible issue, include:

  • the Apify run URL;
  • the non-secret input;
  • the region and chart that failed;
  • the approximate failure time;
  • the expected behavior.

Do not include your API token in support messages.

When a run or a chart fails, the Actor sends sanitized diagnostic data (the exception, your input with secret fields and URL query strings removed, and the Actor, build and run IDs) to our private GlitchTip error-tracking service so we can repair it. Reports are retained for 30 days.

Server API

This Actor is also a Server Actor: it answers one chart per HTTP request from a warm process, usually in about a second. Copy the server URL from the Server tab and call it with your Apify token. Normal runs keep the full input and dataset.

GET /chart

Query parameterRequiredDefaultDescription
regionnousSpotify market code (see Supported markets)
chartnotop-podcaststop-podcasts, trending, top-episodes, or a genre chart (genres only in us, au, br, de, mx, se, gb)
limitno50Rows to return, 1–200
includeRawDatanofalsetrue to add the original Spotify object as rawData

Response 200: { "ok": true, "count": 50, "results": [ <ranked rows, same fields as the dataset> ] }.

Charge: one item event per returned row at your plan's price. No start fee. Errors and empty charts are free.

Limits: 45 seconds per request; up to 8 requests at once per server process (more start another process).

StatusCodeMeaning
400INVALID_INPUTUnknown region or chart, a genre chart in a market without genres, or limit outside 1–200
404CHART_EMPTYSpotify returned no entries for this chart
413REQUEST_TOO_LARGE / RESPONSE_TOO_LARGEBody over 2 KB, or a result over 3 MB
502UPSTREAM_ERRORSpotify returned an error or an unexpected payload; retry later
503OVERLOADED / SHUTTING_DOWNToo many requests in this process, or the server is stopping; retry
504UPSTREAM_TIMEOUT / TIMEOUTSpotify or the request took too long; retry

Errors look like { "ok": false, "error": { "code": "...", "message": "...", "retryable": true } }.

curl -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
"<SERVER_URL_FROM_THE_SERVER_TAB>/chart?region=us&chart=top-episodes&limit=20"