Deezer

Get Deezer track

Get a Deezer track with its credits, copyright, rights, countries, other releases and a 30 second preview link.

GET/v1/deezer/tracks/{trackId}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
trackIdstringrequiredpath

Deezer track id, for example `3135556`.

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

languagestringoptionalquery

Two-letter language code for editorial text, such as `fr`. Titles and names are not translated. Default: `en`.

pattern: ^[a-z]{2}$

Response fields
84

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

The track when found; otherwise null.

datatrackid
integer

Track id.

datatracktitle
string

Track title, version included.

datatracktitleShort
stringnullable

Track title without the version.

datatrackversion
stringnullable

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

datatrackisrc
stringnullable

International Standard Recording Code.

datatrackurl
stringnullable

Track page URL.

datatrackdurationMs
integernullable

Duration in milliseconds.

datatracktrackNumber
integernullable

Position on the disc.

datatrackdiscNumber
integernullable

Disc number.

datatrackrank
integernullable

Deezer's popularity score for the track.

datatrackexplicit
booleannullable

Whether the lyrics are marked explicit.

datatrackavailable
booleannullable

Whether Deezer can play the track in its catalogue.

datatrackpreviewUrl
stringnullable

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

datatrackpreviewExpiresAt
stringnullable

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

datatrackaddedAt
stringnullable

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

The main artist.

datatrackartistid
integer

Artist id.

datatrackartistname
string

Artist name.

datatrackartisturl
stringnullable

Artist page URL.

Picture URLs in four sizes.

datatrackartistimagesid
stringnullable

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

datatrackartistimagessmall
stringnullable

Small image URL (about 56 px).

datatrackartistimagesmedium
stringnullable

Medium image URL (about 250 px).

datatrackartistimagesbig
stringnullable

Large image URL (about 500 px).

datatrackartistimagesxl
stringnullable

Extra-large image URL (about 1000 px).

The album.

datatrackalbumid
integer

Album id.

datatrackalbumtitle
string

Album title.

datatrackalbumurl
stringnullable

Album page URL.

Picture URLs in four sizes.

datatrackalbumimagesid
stringnullable

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

datatrackalbumimagessmall
stringnullable

Small image URL (about 56 px).

datatrackalbumimagesmedium
stringnullable

Medium image URL (about 250 px).

datatrackalbumimagesbig
stringnullable

Large image URL (about 500 px).

datatrackalbumimagesxl
stringnullable

Extra-large image URL (about 1000 px).

datatrackbpm
numbernullable

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

datatrackreplayGain
numbernullable

Replay gain in dB.

datatrackreleasedAt
stringnullable

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

datatrackphysicalReleasedAt
stringnullable

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

Deezer's explicit-content codes.

datatrackexplicitnesslyrics
integernullable

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

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

datatrackavailableCountries[]
stringoptional

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

datatracksubscriptionOnlyCountries[]
stringoptional

When the item may be streamed on each tier.

datatrackavailabilityfreeFrom
stringnullable

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

datatrackavailabilitypremiumFrom
stringnullable

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

datatrackavailabilityfreeAvailable
booleannullable

Whether the free tier may stream it now.

datatrackavailabilitypremiumAvailable
booleannullable

Whether the paid tier may stream it now.

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

datatrackqualities[]
stringoptional

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

datatrackartists[]id
integer

Artist id.

datatrackartists[]name
string

Artist name.

datatrackartists[]url
stringnullable

Artist page URL.

Picture URLs in four sizes.

datatrackartists[]imagesid
stringnullable

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

datatrackartists[]imagessmall
stringnullable

Small image URL (about 56 px).

datatrackartists[]imagesmedium
stringnullable

Medium image URL (about 250 px).

datatrackartists[]imagesbig
stringnullable

Large image URL (about 500 px).

datatrackartists[]imagesxl
stringnullable

Extra-large image URL (about 1000 px).

datatrackartists[]role
stringnullable

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

datatrackartists[]rank
integernullable

Deezer's popularity score for the artist.

datatrackartists[]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.

datatrackcredits[]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.

datatrackcredits[]names[]
stringoptional
datatrackcopyright
stringnullable

Copyright line. Null in batch lookups.

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

datatrackotherReleases[]albumId
integer

Album id of the other release.

datatrackotherReleases[]title
stringnullable

Album title.

datatrackotherReleases[]releasedAt
stringnullable

Release date (YYYY-MM-DD).

datatrackotherReleases[]artistName
stringnullable

Artist name on that release.

datatrackupdatedAt
stringnullable

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

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/3135556" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Track details.