Deezer

List Deezer artist top tracks

List a Deezer artist's most played tracks, up to 100.

GET/v1/deezer/artists/{artistId}/top-tracks
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
artistIdstringrequiredpath

Deezer artist id, for example `27`.

pattern: ^[1-9]\d{0,11}$

limitintegeroptionalquery

Items per page, 1 to 100. Default: 50.

≥ 1 · ≤ 100

Response fields
43

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

The artist's most played tracks, most played first.

datatracks[]id
integer

Track id.

datatracks[]title
string

Track title, version included.

datatracks[]titleShort
stringnullable

Track title without the version.

datatracks[]version
stringnullable

Version label such as `(Radio Edit)`; null for most tracks.

datatracks[]isrc
stringnullable

International Standard Recording Code.

datatracks[]url
stringnullable

Track page URL.

datatracks[]durationMs
integernullable

Duration in milliseconds.

datatracks[]trackNumber
integernullable

Position on the disc.

datatracks[]discNumber
integernullable

Disc number.

datatracks[]rank
integernullable

Deezer's popularity score for the track.

datatracks[]explicit
booleannullable

Whether the lyrics are marked explicit.

datatracks[]available
booleannullable

Whether Deezer can play the track in its catalogue.

datatracks[]previewUrl
stringnullable

A 30 second audio preview. The link is signed and stops working about 15 minutes after the response.

datatracks[]previewExpiresAt
stringnullable

When the preview link stops working (ISO-8601, UTC).

datatracks[]addedAt
stringnullable

When the track was added to the playlist; null outside playlists (ISO-8601, UTC).

The main artist.

datatracks[]artistid
integer

Artist id.

datatracks[]artistname
string

Artist name.

datatracks[]artisturl
stringnullable

Artist page URL.

Picture URLs in four sizes.

datatracks[]artistimagesid
stringnullable

Image identifier; every size URL is built from it. Null when the item has no picture of its own.

datatracks[]artistimagessmall
stringnullable

Small image URL (about 56 px).

datatracks[]artistimagesmedium
stringnullable

Medium image URL (about 250 px).

datatracks[]artistimagesbig
stringnullable

Large image URL (about 500 px).

datatracks[]artistimagesxl
stringnullable

Extra-large image URL (about 1000 px).

The album.

datatracks[]albumid
integer

Album id.

datatracks[]albumtitle
string

Album title.

datatracks[]albumurl
stringnullable

Album page URL.

Picture URLs in four sizes.

datatracks[]albumimagesid
stringnullable

Image identifier; every size URL is built from it. Null when the item has no picture of its own.

datatracks[]albumimagessmall
stringnullable

Small image URL (about 56 px).

datatracks[]albumimagesmedium
stringnullable

Medium image URL (about 250 px).

datatracks[]albumimagesbig
stringnullable

Large image URL (about 500 px).

datatracks[]albumimagesxl
stringnullable

Extra-large image URL (about 1000 px).

datatotal
integernullable

Number of top tracks Deezer lists for the artist (100 at most).

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/deezer/artists/27/top-tracks" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Artist's top tracks.