Deezer

List Deezer account playlists

List a Deezer account's public playlists.

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

API key (`sfk_...`)

Parameters
3
userIdstringrequiredpath

Deezer account id, for example `753546365`.

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

limitintegeroptionalquery

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

≥ 1 · ≤ 100

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.

min 1 chars · max 1000 chars

Response fields
28

Endpoint-specific response payload.

datalookupStatus
string

Whether the account was found, and `private` when its lists are not public.

one of: found, not_found, private

The account's public playlists; empty when the account is private or not found.

dataplaylists[]id
integer

Playlist id.

dataplaylists[]title
string

Playlist title.

dataplaylists[]url
stringnullable

Playlist page URL.

Picture URLs in four sizes.

dataplaylists[]imagesid
stringnullable

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

dataplaylists[]imagessmall
stringnullable

Small image URL (about 56 px).

dataplaylists[]imagesmedium
stringnullable

Medium image URL (about 250 px).

dataplaylists[]imagesbig
stringnullable

Large image URL (about 500 px).

dataplaylists[]imagesxl
stringnullable

Extra-large image URL (about 1000 px).

dataplaylists[]trackCount
integernullable

Number of tracks.

dataplaylists[]fanCount
integernullable

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

dataplaylists[]durationMs
integernullable

Total duration in milliseconds.

dataplaylists[]description
stringnullable

Description.

dataplaylists[]isPublic
booleannullable

Whether the playlist is public.

The account that made the playlist.

dataplaylists[]creatorid
integer

Account id of the creator.

dataplaylists[]creatorname
stringnullable

Display name of the creator.

datatotal
integernullable

Number of public playlists.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

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

Responses

Account's public playlists.