Free Spotify Charts Scraper — Global Top 50 Tracks, Albums & Artists with Rank Deltas

Scrape Spotify's official Global Weekly charts — Top Tracks, Top Albums, Top Artists — with current_rank, previous_rank, peak_rank, appearances_on_chart, and an automatic climbers/fallers/new-entry classification. Run-over-run diff layer included. $0.0015 per chart entry.

What you get

• chart_alias (e.g. REGIONAL_GLOBAL_WEEKLY), title, description, entity_type (track / album / artist), country (GLOBAL), recurrence (WEEKLY), date, latest_date, earliest_date
• entries[] — typically 50-200 per chart with:
  • current_rank, previous_rank, peak_rank
  • appearances_on_chart, consecutive_appearances
  • entry_status_raw (Spotify's own NEW_ENTRY / RE_ENTRY / etc.) plus a normalized entry_status (new, re_entry, dropped, climber (≥10 spots up), faller (≥10 down), moved_up, moved_down, unchanged)
  • For tracks: name, uri, artists[], image_url, labels[], release_date
  • For albums: name, uri, artists[], image_url, release_date
  • For artists: name, uri, image_url
• diff block — when trackDiffs is on, every run after the first emits added, removed, moved, summary with counts plus per-entry detail vs the previous snapshot

Why scrape Spotify charts

Spotify shut down its public Charts CSV downloads in early 2024 and deprecated the chart-related Web API endpoints in November 2024. The charts.spotify.com web app is now the only public surface for the Top 50 / Top 200 / Viral charts data — and it's a JS-rendered SPA with an undocumented bearer-token-protected JSON catalog endpoint behind it.

This actor hits that catalog endpoint directly (

charts-spotify-com- service.spotify.com/public/v0/charts

The diff layer is the differentiator. The Spotify Charts UI shows this week vs last week. This actor stores every run as a snapshot, so on the second run forward you also get added / removed / moved deltas computed against your last poll, not just against the chart position from the prior week. Useful when you want to track intra-week movement or your own custom comparison windows.

Input

Important: Country-level charts (e.g. US Top 50, UK Top 50, Top 50 Indonesia) are auth-walled by Spotify — only the Global Weekly charts are anonymously available. If the catalog returns it, this actor surfaces it; if Spotify locks it behind login, no anonymous scraper can return it.

Output

{
  "chart_uri": "spotify:chart:regional-global-weekly",
  "chart_alias": "REGIONAL_GLOBAL_WEEKLY",
  "title": "Top Songs - Global - Weekly",
  "entity_type": "track",
  "country": "GLOBAL",
  "chart_type": "TOP_TRACK",
  "recurrence": "WEEKLY",
  "date": "2026-04-24",
  "latest_date": "2026-04-24",
  "entries": [
    {
      "position": 0,
      "current_rank": 1,
      "previous_rank": 3,
      "peak_rank": 1,
      "appearances_on_chart": 12,
      "consecutive_appearances": 12,
      "entry_status_raw": "MOVED_UP",
      "entry_status": "moved_up",
      "uri": "spotify:track:abc123...",
      "id": "abc123...",
      "name": "Example Track Name",
      "image_url": "https://i.scdn.co/image/...",
      "artists": [{"name": "Artist Name", "uri": "spotify:artist:..."}],
      "labels": ["Republic Records"],
      "release_date": "2026-02-14"
    }
  ],
  "diff": {
    "is_first_snapshot": false,
    "summary": {"added": 5, "removed": 5, "moved": 12, "unchanged": 33},
    "added": [{"position": 0, "uri": "spotify:track:...", "name": "..."}]
  }
}

Use cases

Music journalist / Substack writer doing a "this week on Spotify Global" column. The full Top 50 with previous_rank, peak_rank, and entry_status: climber already classified saves the manual diffing. Run on Friday after the chart refresh. Filter entry_status to new and climber and you have your lede tracks. $0.075 per Top 50 weekly run.

Label marketing manager tracking their roster's chart positions. Run the global weekly track + album + artist charts every Friday, filter entries[] by your roster's artist URIs, log current_rank deltas to BigQuery. Build a weekly dashboard for the C-suite without paying Chartmetric Pro at $140/month for data that's anonymously available anyway.

Music data researcher / academic building a longitudinal dataset of chart movement. The appearances_on_chart and consecutive_appearances fields give you durability metrics out of the box, and the diff store gives you week-over-week added/removed/ moved without you having to write the join.

Sync-licensing supervisor monitoring chart climbers as a leading signal of which tracks are about to break mainstream — too late once they hit Top 10, but entry_status: climber (≥10 positions up week-over-week) inside the Top 100 is exactly the band where licensing is still affordable. $0.0015 per entry × 50 = $0.075 a week.

How it compares

The serious paid alternatives — Chartmetric, Soundcharts, Spotontrack — start at $90-300/month flat-rate and cover country charts that Spotify auth-walls from anonymous scrapers. They're the right answer if you need US/UK/Brazil/etc. charts. For Global Weekly tracking specifically, this actor is the cheapest pay-per-use path with the diff layer included.

Pricing

• $0.0015 per chart entry returned
• All pricing is pay-per-event — you only pay per result. No actor-start fee. A 50-entry Top 50 chart costs $0.075 per run. Three charts × 50 entries × weekly = ~$0.45/month.

Limits and gotchas

• Anonymous scraping — no Spotify account or Premium needed.
• Country charts are auth-walled — Spotify only allows anonymous access to the Global Weekly charts. Region-specific Top 50s (US, UK, BR, ID, etc.) require login and aren't returned by the anonymous catalog endpoint. This is a Spotify policy, not a scraper limit.
• Chart refresh cadence — Spotify publishes the weekly charts every Friday (typically 00:00 UTC). Running the actor outside that window returns the prior week's data unchanged.
• Diff state — first run is always is_first_snapshot: true with empty diff arrays. Run twice to see the first real diff.
• labels[] field for tracks is sometimes empty for indie releases — that's Spotify not having the metadata, not a scraper bug.
• Entry status semantics — entry_status: climber and faller in this actor mean ≥10 positions of movement (our normalization). Spotify's raw entry_status_raw uses different buckets; both are surfaced so you can pick.
• Cold-start time is ~3-5s; the catalog endpoint returns all available charts in one shot.

FAQ

Can I scrape Spotify charts after the official charts API was deprecated? Yes. The Spotify Web API charts endpoints were deprecated in November 2024, but charts.spotify.com is still publicly accessible. This actor hits the same JSON catalog the web UI calls, with anonymous embed-token auth. No Spotify account or developer-app required.

How often does Spotify update the Top 50 chart? Weekly, every Friday. The cadence has been stable for years. Daily charts (Top 200 / Viral 50) are not currently in the anonymous catalog response — only the weekly cuts.

Can I get the US Top 50 or UK Top 50 with this actor? Not anonymously. Country-level charts on charts.spotify.com require a logged-in session. This actor returns whatever the anonymous catalog endpoint surfaces, which today is the Global Weekly Top Tracks / Albums / Artists.

What's the cost to track all global charts weekly? Approximately $0.45/month for the three flagship Global Weekly charts (50 entries each × 4 weeks × $0.0015). Trivial compared to Chartmetric Pro at $140/month.

How do I detect chart climbers and breakouts? Filter entries[] where entry_status: "climber" (≥10 spots up week-over-week) or entry_status: "new" (just entered the chart). The diff.added array gives you the same view but computed against your previous run rather than against last week's chart.

Related Actors

• Free Spotify Artist Analytics — monthly listeners, world rank, top tracks with playcount per chart-climbing artist
• Free Spotify Playlist Intelligence — playlist tracklists, follower count, editorial flag, run-over-run diff
• Free Spotify Podcast Catalog — podcast show metadata, episodes, ratings, publisher