List Deezer account favourites
List a Deezer account's favourite albums, artists or tracks.
Headers
Get your API keyAPI key (`sfk_...`)
Deezer account id, for example `753546365`.
pattern: ^[1-9]\d{0,11}$
Which part of the library to list.
one of: albums, artists, tracks
Items per page, 1 to 100. Default: 50.
≥ 1 · ≤ 100
Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.
min 1 chars · max 1000 chars
Endpoint-specific response payload.
Whether the account was found, and `private` when its lists are not public.
one of: found, not_found, private
Which part of the library this is.
one of: albums, artists, tracks
Favourite albums when `kind` is `albums`; otherwise null.
Album id.
Album title.
Album page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Release type.
one of: album, ep, single, compilation, null
Release date. Deezer's original release date when it gives one, otherwise its release date. (YYYY-MM-DD).
Number of tracks.
Number of fans; null when the record does not carry one.
Whether the album is marked explicit.
The main artist.
Artist id.
Artist name.
Artist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Favourite artists when `kind` is `artists`; otherwise null.
Artist id.
Artist name.
Artist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Number of fans; null when the record does not carry one.
Favourite tracks when `kind` is `tracks`; otherwise null.
Track id.
Track title, version included.
Track title without the version.
Version label such as `(Radio Edit)`; null for most tracks.
International Standard Recording Code.
Track page URL.
Duration in milliseconds.
Position on the disc.
Disc number.
Deezer's popularity score for the track.
Whether the lyrics are marked explicit.
Whether Deezer can play the track in its catalogue.
A 30 second audio preview. The link is signed and stops working about 15 minutes after the response.
When the preview link stops working (ISO-8601, UTC).
When the track was added to the playlist; null outside playlists (ISO-8601, UTC).
The main artist.
Artist id.
Artist name.
Artist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
The album.
Album id.
Album title.
Album page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Number of items in this part of the library.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/deezer/users/5/library?kind=albums" \
-H "x-api-key: YOUR_API_KEY"Responses
Account's favourites.