Deezer

Get several Deezer tracks

Get up to 200 Deezer tracks in one request; ids that match nothing are listed.

GET/v1/deezer/tracks
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
idsarrayrequiredquery

Comma-separated Deezer track ids, 1 to 200.

Response fields
86

Endpoint-specific response payload.

datarequested
integer

Number of distinct ids asked for.

Tracks found, in the order asked for.

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).

datatracks[]bpm
numbernullable

Beats per minute; null when Deezer has no value, and null in batch lookups.

datatracks[]replayGain
numbernullable

Replay gain in dB.

datatracks[]releasedAt
stringnullable

Release date. The digital release date when Deezer gives one. (YYYY-MM-DD).

datatracks[]physicalReleasedAt
stringnullable

Physical release date. (YYYY-MM-DD).

Deezer's explicit-content codes.

datatracks[]explicitnesslyrics
integernullable

Deezer's explicit-lyrics code: 0 not explicit, 1 explicit, 2 unknown, and other values on albums (4, 6, 7) that mix tracks.

datatracks[]explicitnesscover
integernullable

Deezer's explicit-cover code: 0 not explicit, 1 explicit.

ISO country codes where the track can be streamed; null when Deezer sent no list, including in batch lookups.

datatracks[]availableCountries[]
stringoptional

Countries where only paying subscribers can stream it; null in batch lookups.

datatracks[]subscriptionOnlyCountries[]
stringoptional

When the item may be streamed on each tier.

datatracks[]availabilityfreeFrom
stringnullable

Date from which the item may be streamed on the free tier (YYYY-MM-DD).

datatracks[]availabilitypremiumFrom
stringnullable

Date from which the item may be streamed on the paid tier (YYYY-MM-DD).

datatracks[]availabilityfreeAvailable
booleannullable

Whether the free tier may stream it now.

datatracks[]availabilitypremiumAvailable
booleannullable

Whether the paid tier may stream it now.

Encodings that exist for the track, such as `mp3_128`, `mp3_320` and `flac`.

datatracks[]qualities[]
stringoptional

Every artist credited on the track, in credit order. Batch lookups may leave artist images empty.

datatracks[]artists[]id
integer

Artist id.

datatracks[]artists[]name
string

Artist name.

datatracks[]artists[]url
stringnullable

Artist page URL.

Picture URLs in four sizes.

datatracks[]artists[]imagesid
stringnullable

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

datatracks[]artists[]imagessmall
stringnullable

Small image URL (about 56 px).

datatracks[]artists[]imagesmedium
stringnullable

Medium image URL (about 250 px).

datatracks[]artists[]imagesbig
stringnullable

Large image URL (about 500 px).

datatracks[]artists[]imagesxl
stringnullable

Extra-large image URL (about 1000 px).

datatracks[]artists[]role
stringnullable

How the artist is credited on the item: `main`, `featured`, or the credit as Deezer words it.

datatracks[]artists[]rank
integernullable

Deezer's popularity score for the artist.

datatracks[]artists[]names
object

The artist's name in other languages and scripts, keyed by language tag.

People credited on the track, grouped by role. Empty in batch lookups.

datatracks[]credits[]role
string

The credit role as Deezer words it, for example `main_artist`, `composer`, `author` or `mastering engineer`. Roles are free text and spelled inconsistently.

People credited in this role.

datatracks[]credits[]names[]
stringoptional
datatracks[]copyright
stringnullable

Copyright line. Null in batch lookups.

Other releases that carry the same recording (same ISRC). Empty in batch lookups.

datatracks[]otherReleases[]albumId
integer

Album id of the other release.

datatracks[]otherReleases[]title
stringnullable

Album title.

datatracks[]otherReleases[]releasedAt
stringnullable

Release date (YYYY-MM-DD).

datatracks[]otherReleases[]artistName
stringnullable

Artist name on that release.

datatracks[]updatedAt
stringnullable

When Deezer last changed the record; null in batch lookups. (ISO-8601, UTC).

Ids that matched no track.

datanotFoundIds[]
integeroptional

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/tracks?ids=3135556,916424" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Deezer tracks.