Deezer

Get Deezer playlist

Get a Deezer playlist's details.

GET/v1/deezer/playlists/{playlistId}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
playlistIdstringrequiredpath

Deezer playlist id, for example `908622995`.

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
30

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

The playlist when found; otherwise null. A private or deleted playlist is also null.

dataplaylistid
integer

Playlist id.

dataplaylisttitle
string

Playlist title.

dataplaylisturl
stringnullable

Playlist page URL.

Picture URLs in four sizes.

dataplaylistimagesid
stringnullable

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

dataplaylistimagessmall
stringnullable

Small image URL (about 56 px).

dataplaylistimagesmedium
stringnullable

Medium image URL (about 250 px).

dataplaylistimagesbig
stringnullable

Large image URL (about 500 px).

dataplaylistimagesxl
stringnullable

Extra-large image URL (about 1000 px).

dataplaylisttrackCount
integernullable

Number of tracks.

dataplaylistfanCount
integernullable

Number of fans; null when the record does not carry one.

dataplaylistdurationMs
integernullable

Total duration in milliseconds.

dataplaylistdescription
stringnullable

Description.

dataplaylistisPublic
booleannullable

Whether the playlist is public.

The account that made the playlist.

dataplaylistcreatorid
integer

Account id of the creator.

dataplaylistcreatorname
stringnullable

Display name of the creator.

dataplaylistisCollaborative
booleannullable

Whether other accounts can add tracks.

dataplaylistisEditorial
booleannullable

Whether the playlist is made by Deezer's editors.

dataplaylistisSponsored
booleannullable

Whether the playlist is sponsored.

dataplaylisthasLinkedArtist
booleannullable

Whether the playlist is tied to an artist.

dataplaylistcreatedAt
stringnullable

When the playlist was created (ISO-8601, UTC).

dataplaylistupdatedAt
stringnullable

When the playlist last changed (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/playlists/908622995" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Deezer playlist.