Rankings
Charts
Three ranked reads of the catalog, each one a single documented call.
How the charts API works — what a chart row carries, and how to backfill a past day.
GET /top_200_tracks
Top 200 tracks worldwide
The Top 200 did not load
The chart request came back empty. It is a live call against a rate-limited proxy, so a retry usually clears it.
6 chart endpoints
Spotify publishes no charts API; every row above is one documented GET against this one. The whole Charts group, with the parameters each call takes:
- GET /top_20_by_monthly_listeners
Top 20 by monthly listeners
Params
none - GET /top_200_tracks
Top 200 tracks
Params
period, country, date - GET /top_artists
Top artists chart
Params
period, country - GET /top_albums
Top albums chart
Params
period, country - GET /viral_tracks
Viral tracks chart
Params
country - GET /top_20_by_followers
Top 20 by followers
Params
none
The recorded /top_200_tracks sample carries, per entry, currentRank, previousRank, peakRank, appearancesOnChart and a rankingMetric of type STREAMS — which is where the peak and appearance figures in the list above come from.
FAQ
Does Spotify have an official charts API?
No. Spotify publishes charts at charts.spotify.com but the Web API has never exposed them, and the open-source scrapers that used to fill the gap stopped working when the charts site moved behind login. The six endpoints above are how this API serves them.
What is the difference between Top 200 and Viral 50?
Top 200 (/top_200_tracks) ranks by streams and carries each entry's current, previous and peak rank plus how many days it has charted. Viral 50 (/viral_tracks) is Spotify's virality ranking, which weighs how fast a track is being shared and discovered rather than raw stream volume.
How often do the charts refresh?
Daily. /top_200_tracks and /top_artists also accept period=weekly, and /top_200_tracks takes a date parameter so a past chart day can be requested.
Can I get a chart for one country?
Yes. /top_200_tracks, /viral_tracks, /top_artists and /top_albums all take a country parameter; without it the global chart is returned.
Where do the monthly-listener figures come from?
/top_20_by_monthly_listeners returns each artist's rank and monthly listeners in millions, and /artist_overview returns the exact monthly-listener count for any single artist id.