Social Fetch
Start for freeStart free
Deezer hub

Deezer Charts API

Five chart kinds, a genre filter and a country tracks chart.

GET /v1/deezer/charts

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/deezer/charts returns lookupStatus, type, genreId, country, the list for the chosen chart, and windowLimited. Set type to tracks, albums, artists, playlists or podcasts; genreId filters by genre and 0 means all genres. limit accepts 1 to 300 and defaults to 100.

country is only for a tracks chart with all genres. If it is combined with another type or a genre, the request is refused with a 400 before any lookup. A country tracks chart holds at most 100 rows and sets windowLimited when limit asks for more. Rows in a country tracks chart do not carry previewUrl, previewExpiresAt, rank, available, titleShort, version, trackNumber or discNumber, so those fields are null.

Deezer Charts 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.

Can I get a country chart for albums?

No. country is only accepted with type=tracks and genreId=0 or omitted. Other chart kinds follow the region of the request.

Why did the chart return fewer rows than limit?

The country tracks chart is limited to 100 rows. windowLimited is true when the window was smaller than limit.

Other Deezer endpoints