Social Fetch
Start for freeStart free
Deezer hub

Deezer Account Favourites API

Favourite albums, artists or tracks, one kind per request.

GET /v1/deezer/users/{userId}/library

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/deezer/users/{userId}/library?kind=tracks returns lookupStatus, kind, total, page and the matching list. kind is required and is albums, artists or tracks; the other two lists are null. limit accepts 1 to 100 and defaults to 50.

The status is found, not_found or private. A private account returns private with an empty list. A page can hold fewer rows than limit while page.hasMore is true; follow page.nextCursor until it is false. Favourite items use the list album, artist or track shape.

Deezer Account Favourites API FAQ

How many credits does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Which kinds can I request?

albums, artists or tracks. kind is required, so one request returns one part of the library.

Why are two lists null?

Only the list matching kind is populated. The other two are null rather than empty, so you can tell the request kind from an empty result.

Why does a page have fewer rows than limit?

A page can hold fewer rows than limit while page.hasMore is true. Follow page.nextCursor until it is false; do not treat a short page as the end.

Other Deezer endpoints