Charts · GET
Top 200 tracks
GET /top_200_tracks
About
Top 200 tracks is a GET endpoint in the Charts group of the Spotify Data API. It takes 3 parameters: period, country and date (optional). The recorded sample response, captured 2025-06-07, is a JSON array of 200 objects: [].chartEntryData, [].missingRequiredFields and [].trackMetadata.
Parameters 3
- period Optional
- In
- query
- Default
- daily
- country Optional
- In
- query
- Default
- global
- date Optional
- In
- query
- Default
- —
Request
Against https://spotify-proxy.checkleaked.cc, with the same example values the Run button sends.
| curl -X GET \ |
| "https://spotify-proxy.checkleaked.cc/top_200_tracks?period=daily&country=global" \ |
| -H "x-api-key: $SPOTIFY_API_KEY" |
Sample response
Recorded sample · captured 2025-06-07
| [ |
| { |
| "chartEntryData": { |
| "currentRank": 1, |
| "previousRank": -1, |
| "peakRank": 1, |
| "peakDate": "2025-06-06", |
| "appearancesOnChart": 1, |
| "consecutiveAppearancesOnChart": 1, |
| "rankingMetric": { |
| "value": "8052003", |
| "type": "STREAMS" |
| }, |
| "entryStatus": "NEW_ENTRY", |
| "entryRank": 1, |
| "entryDate": "2025-06-06" |
| }, |
| "missingRequiredFields": false, |
| "trackMetadata": { |
| "trackName": "Manchild", |
| "trackUri": "spotify:track:42UBPzRMh5yyz0EDPr6fr1", |
| "displayImageUri": "https://i.scdn.co/image/ab67616d00001e02062c6573009fdebd43de443b", |
| "artists": [ |
| { |
| "name": "Sabrina Carpenter", |
| "spotifyUri": "spotify:artist:74KM79TiuVKeVCqs8QtB0B", |
| "externalUrl": "" |
| } |
| ], |
| "producers": [], |
| "labels": [ |
| { |
| "name": "Island Records", |
| "spotifyUri": "", |
| "externalUrl": "" |
| } |
| ], |
| "songWriters": [], |
| "releaseDate": "2025-06-05" |
| } |
| }, |
| { |
| "chartEntryData": { |
| "currentRank": 2, |
| "previousRank": 1, |
| "peakRank": 1, |
| "peakDate": "2025-05-08", |
| "appearancesOnChart": 120, |
| "consecutiveAppearancesOnChart": 120, |
| "rankingMetric": { |
| "value": "6068819", |
| "type": "STREAMS" |
| }, |
| "entryStatus": "MOVED_DOWN", |
| "entryRank": 48, |
| "entryDate": "2025-02-07" |
| }, |
| "missingRequiredFields": false, |
| "trackMetadata": { |
| "trackName": "Ordinary", |
| "trackUri": "spotify:track:2RkZ5LkEzeHGRsmDqKwmaJ", |
| "displayImageUri": "https://i.scdn.co/image/ab67616d00001e02445583cf76246ed491bb10cf", |
| "artists": [ |
| { |
| "name": "Alex Warren", |
| "spotifyUri": "spotify:artist:0fTSzq9jAh4c36UVb4V7CB", |
| "externalUrl": "" |
| } |
| ], |
| "producers": [], |
| "labels": [ |
| { |
| "name": "Atlantic Records", |
| "spotifyUri": "", |
| "externalUrl": "" |
| } |
| ], |
| "songWriters": [], |
| "releaseDate": "2024-09-26" |
| } |
The first 80 of 8,417 lines. Press Run for the full body.
Response fields
Read off the recorded sample, not a schema: a JSON array of 200 objects.
[].chartEntryDataobject[].missingRequiredFieldsboolean[].trackMetadataobject
Errors
- 400
- No parameter on this endpoint is required, so a 400 means one that was sent carries a value it does not accept — check the allowed values in the table above.
- 401 / 403
- The key is missing, wrong, or on a plan that does not include this endpoint. On RapidAPI the header is X-RapidAPI-Key; on the Direct Portal it is an Authorization: Bearer token; on Apify the actor supplies it.
- 429
- Rate limited. The demo on this site allows 100 requests per 15 minutes and 500 per day per visitor, inside a budget shared by every visitor. With a key it is 5 requests per second on every RapidAPI plan and 10 per second on the Direct Portal.
- 5xx
- Spotify itself failed or timed out. These are transient; retry once with a short backoff rather than immediately.
Related endpoints
The other 5 operations in the Charts group.