Deezer Artist Top Tracks API
The artist's most played tracks, ready for a chart or a starting queue.
GET /v1/deezer/artists/{artistId}/top-tracks1 credit Failed requests are free
About this endpoint
GET /v1/deezer/artists/{artistId}/top-tracks returns lookupStatus, tracks and total. Tracks are ordered most played first and use the list track shape: id, title, durationMs, rank, artist, album, previewUrl and the rest of the list fields. limit accepts 1 to 100 and defaults to 50.
An artist that exists but has no top tracks returns lookupStatus: found with an empty tracks array. An unknown artist returns not_found, so an empty list is not confused with a missing artist.
Deezer Artist Top Tracks API FAQ
How many credits does this route cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
How many top tracks can I ask for?
limit accepts 1 to 100 and defaults to 50. total says how many Deezer lists for the artist, up to 100.
What is the difference between found and empty?
found with an empty tracks array means the artist exists but has no top tracks. not_found means the artist id itself was not found.
Other Deezer endpoints
- TrackGET /v1/deezer/tracks/{trackId}
- Track by ISRCGET /v1/deezer/tracks/isrc/{isrc}
- Tracks batchGET /v1/deezer/tracks
- LyricsGET /v1/deezer/tracks/{trackId}/lyrics
- AlbumGET /v1/deezer/albums/{albumId}
- Album by barcodeGET /v1/deezer/albums/upc/{upc}
- Albums batchGET /v1/deezer/albums
- ArtistGET /v1/deezer/artists/{artistId}