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 · chart week of 2026-10-14
Top 200 tracks worldwide
- 1
BbY WOW
KAROL G, Judeline, rusowsky
- 2
Nicole Kidman
ADÉLA
- 3
the cure
Olivia Rodrigo
- 4
Ain't In LA
ADÉLA
- 5
Earrings
Malcolm Todd
- 6
stupid song
Olivia Rodrigo
- 7
Stop The Wedding!
Ashe
- 8
Beauty And A Beat
Justin Bieber, Nicki Minaj
- 9
back to friends
sombr
- 10
Die With A Smile
Lady Gaga, Bruno Mars
- 11
The One That Got Away
Katy Perry
- 12
Patient Zero
Taylor Swift
- 13
Sweater Weather
The Neighbourhood
- 14
Love Me Not
Ravyn Lenae
- 15
Iris
The Goo Goo Dolls
- 16
Babydoll
Dominic Fike
- 17
Man I Need
Olivia Dean
- 18
Self Aware
Temper City
- 19
Great Expectation
SIENNA SPIRO
- 20
SWIM
BTS
- 21
Loser
Tame Impala
- 22
Treat You Better
Shawn Mendes
- 23
Just Give Me a Reason (feat. Nate Ruess)
P!nk, Nate Ruess
- 24
Sailor Song
Gigi Perez
- 25
Training Season
Dua Lipa
- 26
hate that i made you love me
Ariana Grande
- 27
Cinderella (feat. Ty Dolla $ign)
Mac Miller, Ty Dolla $ign
- 28
End of Beginning
Djo
- 29
BIRDS OF A FEATHER
Billie Eilish
- 30
One Of The Girls (with JENNIE, Lily Rose Depp)
The Weeknd, JENNIE, Lily-Rose Depp
- 31
Ordinary
Alex Warren
- 32
Choosin' Texas
Ella Langley
- 33
Billie Jean
Michael Jackson
- 34
Mr. Brightside
The Killers
- 35
Wonderwall - Remastered
Oasis
- 36
Dai Dai
Shakira, Burna Boy
- 37
drop dead
Olivia Rodrigo
- 38
Pós - Ao Vivo
Felipe e Rodrigo
- 39
Sign of the Times
Harry Styles
- 40
The Fate of Ophelia
Taylor Swift
- 41
Creep
Radiohead
- 42
I Wanna Be Yours
Arctic Monkeys
- 43
Every Breath You Take
The Police
- 44
Risk It All
Bruno Mars
- 45
Starboy
The Weeknd, Daft Punk
- 46
WILDFLOWER
Billie Eilish
- 47
Die On This Hill
SIENNA SPIRO
- 48
Cuando No Era Cantante RMX - Remix
El Bogueto, Anuel AA, Fuerza Regida, Yung Beef
- 49
Yellow
Coldplay
- 50
So Easy (To Fall In Love)
Olivia Dean
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.