Spotify Podcast Charts Scraper
Pricing
from $0.03 / 1,000 item extracteds
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
Maintained by CommunityActor stats
0
Bookmarked
14
Total users
4
Monthly active users
2 days ago
Last modified
Categories
Features
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, andchart. - 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-podcaststrendingtop-episodes(ranked episodes; adds theepisode*fields)
Genre charts:
artsbusinesscomedyeducationfictionhealth-fitnesshistoryleisuremusicnewsreligion-spiritualitysciencesociety-culturesportstechnologytrue-crimetv-film
Quick start
- Open the Actor input.
- Select one or more Regions.
- Select one or more Charts.
- Set Maximum shows per chart.
- Leave raw data disabled unless you need the source object.
- Click Start.
- Open Dataset → Podcast rankings when the run succeeds.
- 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
| Field | Type | Default | Description |
|---|---|---|---|
regions | string[] | ["us"] | Spotify two-letter market codes to collect. |
charts | string[] | ["top-podcasts"] | Ranking lists to collect in every selected region. |
maxItemsPerChart | integer | 100 | Maximum rows per region/chart pair, from 1 to 200. |
includeRawData | boolean | false | Include 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
| Field | Type | Meaning |
|---|---|---|
rank | integer | One-based position in this chart snapshot. |
showUri | string | Spotify URI, such as spotify:show:.... |
showId | string | ID extracted from the Spotify URI. |
showUrl | string | Public Spotify show URL. |
showName | string | Podcast title. |
publisher | string or null | Publisher/creator supplied by Spotify. |
description | string or null | Current Spotify show description. |
artworkUrl | string or null | Spotify artwork URL; the image is not downloaded. |
chartRankMove | string or null | Usually UP, DOWN, or UNCHANGED. |
episodeUri | string or null | Spotify episode URI on the Top Episodes chart; null on show charts. |
episodeId | string or null | Episode ID from the URI (Top Episodes only). |
episodeUrl | string or null | Public Spotify episode URL (Top Episodes only). |
episodeName | string or null | Episode title (Top Episodes only). |
episodeDescription | string or null | Episode show notes (Top Episodes only). |
episodeArtworkUrl | string or null | Episode artwork URL (Top Episodes only). |
region | string | Requested Spotify market code. |
chart | string | Requested chart identifier. |
observedAt | ISO timestamp | UTC observation time shared by this run. |
sourceUrl | string | Corresponding public Spotify chart page. |
rawData | object, optional | Original 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 tier | Price 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:
- run every morning;
- export rows to BigQuery, Snowflake, Sheets, or S3;
- compare each show with its prior snapshot;
- alert when a show enters the top 20;
- 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 osfrom apify_client import ApifyClientclient = 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().itemsprint(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.
Related Automation Lab Actors
- Spotify Scraper — broader Spotify entity and metadata workflows.
- Podcast Scraper — Apple Podcasts search, show metadata, and episodes.
- Spotify Public Weekly Charts Scraper — current weekly songs, albums, and artists rankings.
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 parameter | Required | Default | Description |
|---|---|---|---|
region | no | us | Spotify market code (see Supported markets) |
chart | no | top-podcasts | top-podcasts, trending, top-episodes, or a genre chart (genres only in us, au, br, de, mx, se, gb) |
limit | no | 50 | Rows to return, 1–200 |
includeRawData | no | false | true 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).
| Status | Code | Meaning |
|---|---|---|
| 400 | INVALID_INPUT | Unknown region or chart, a genre chart in a market without genres, or limit outside 1–200 |
| 404 | CHART_EMPTY | Spotify returned no entries for this chart |
| 413 | REQUEST_TOO_LARGE / RESPONSE_TOO_LARGE | Body over 2 KB, or a result over 3 MB |
| 502 | UPSTREAM_ERROR | Spotify returned an error or an unexpected payload; retry later |
| 503 | OVERLOADED / SHUTTING_DOWN | Too many requests in this process, or the server is stopping; retry |
| 504 | UPSTREAM_TIMEOUT / TIMEOUT | Spotify 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"