Deezer Artist Discography API
Albums, EPs and singles, filtered and sorted the way you need them.
GET /v1/deezer/artists/{artistId}/albums1 credit Failed requests are free
About this endpoint
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.
Deezer Artist Discography 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.
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.
Other Deezer endpoints
- TrackGET /v1/deezer/tracks/{trackId}
- Track by ISRCGET /v1/deezer/tracks/isrc/{isrc}
- Tracks batchGET /v1/deezer/tracks
- LyricsGET /v1/deezer/tracks/{trackId}/lyrics
- AlbumGET /v1/deezer/albums/{albumId}
- Album by barcodeGET /v1/deezer/albums/upc/{upc}
- Albums batchGET /v1/deezer/albums
- ArtistGET /v1/deezer/artists/{artistId}