> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/deezer/users-userid-library>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/deezer/users-userid-library.mdx>

---

# Deezer Account Favourites API

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

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

## Request

- **Endpoint:** `GET /v1/deezer/users/{userId}/library`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by account id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/deezer/users/userid/library/get)
- **Platform page:** [/platforms/deezer](https://www.socialfetch.dev/platforms/deezer)

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