Get Deezer chart
Get a Deezer chart of tracks, albums, artists, playlists or podcasts, with a country for the tracks chart.
Headers
Get your API keyAPI key (`sfk_...`)
Which chart. Default: `tracks`.
one of: tracks, albums, artists, playlists, podcasts
Genre id from the genres list; `0` (default) is all genres.
pattern: ^(0|[1-9]\d{0,5})$
Two-letter country code for the tracks chart, for example `BR`. Only with `type=tracks` and all genres; the other charts follow Deezer's default region.
pattern: ^[A-Z]{2}$
Items per page, 1 to 300. Default: 100.
≥ 1 · ≤ 300
Endpoint-specific response payload.
Whether the item was found.
one of: found, not_found
Which chart this is.
one of: tracks, albums, artists, playlists, podcasts
The genre the chart covers; 0 is all genres.
Country of the tracks chart; null for the charts that follow Deezer's default region.
Chart when `type` is `tracks`; otherwise null. Rows in a country chart carry no preview link or expiry, popularity rank, playable flag, short title, version, track number or disc number, so those fields are null.
Track id.
Track title, version included.
Track title without the version.
Version label such as `(Radio Edit)`; null for most tracks.
International Standard Recording Code.
Track page URL.
Duration in milliseconds.
Position on the disc.
Disc number.
Deezer's popularity score for the track.
Whether the lyrics are marked explicit.
Whether Deezer can play the track in its catalogue.
A 30 second audio preview. The link is signed and stops working about 15 minutes after the response.
When the preview link stops working (ISO-8601, UTC).
When the track was added to the playlist; null outside playlists (ISO-8601, UTC).
The main artist.
Artist id.
Artist name.
Artist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
The album.
Album id.
Album title.
Album page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Chart when `type` is `albums`; otherwise null.
Album id.
Album title.
Album page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Release type.
one of: album, ep, single, compilation, null
Release date. Deezer's original release date when it gives one, otherwise its release date. (YYYY-MM-DD).
Number of tracks.
Number of fans; null when the record does not carry one.
Whether the album is marked explicit.
The main artist.
Artist id.
Artist name.
Artist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Chart when `type` is `artists`; otherwise null.
Artist id.
Artist name.
Artist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Number of fans; null when the record does not carry one.
Chart when `type` is `playlists`; otherwise null.
Playlist id.
Playlist title.
Playlist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Number of tracks.
Number of fans; null when the record does not carry one.
Total duration in milliseconds.
Description.
Whether the playlist is public.
The account that made the playlist.
Account id of the creator.
Display name of the creator.
Chart when `type` is `podcasts`; otherwise null.
Show id.
Show title.
Show page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Description.
Number of fans; null when the record does not carry one.
Whether the show is available.
Whether the chart window was smaller than `limit`. The country tracks chart holds at most 100 rows.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/deezer/charts?type=tracks" \
-H "x-api-key: YOUR_API_KEY"Responses
Deezer chart.