> **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/artists-artistid-albums>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/deezer/artists-artistid-albums.mdx>

---

# Deezer Artist Discography API

Albums, EPs and singles, filtered and sorted the way you need them.

`GET /v1/deezer/artists/{artistId}/albums` returns `lookupStatus`, `albums`, `page` and `windowLimited`. It filters with `role` (`main` or `featured`), `includeNonOfficial`, `recordType` (`album`, `ep`, `single`), `subType` (`studio`, `live`, `compilation`, `karaoke`) and sorts by `title`, `newest` or `popular`. `limit` accepts 1 to 500 and defaults to 100. `releasedAt` is the original release date when Deezer gives one, otherwise the release date, the same meaning the album lookup uses.

Deezer stops listing at 500 releases for one combination of filters. When that happens `windowLimited` is true: split the request by role, type or kind to reach the rest. An unknown artist returns `not_found`.

## Request

- **Endpoint:** `GET /v1/deezer/artists/{artistId}/albums`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by artist id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/deezer/artists/artistid/albums/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.

### What does windowLimited mean?

The list reached Deezer's 500 release cap for that filter combination. Narrow the role, recordType or subType filters and page each combination separately.

### How do I page a discography?

Send page.nextCursor as cursor and keep every filter the same. The cursor is minted for this endpoint and these filters, so another list's cursor is refused.