Deezer

List Deezer artist releases

List a Deezer artist's releases or appearances.

GET/v1/deezer/artists/{artistId}/albums
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
8
artistIdstringrequiredpath

Deezer artist id, for example `27`.

pattern: ^[1-9]\d{0,11}$

rolestringoptionalquery

`main` (default) lists the artist's own releases; `featured` lists releases they appear on.

one of: main, featured

includeNonOfficialbooleanoptionalquery

Also list releases that are not official artist releases but credit the artist. Default: false.

recordTypestringoptionalquery

Only releases of this type.

one of: album, ep, single

subTypestringoptionalquery

Only releases of this kind.

one of: studio, live, compilation, karaoke

sortstringoptionalquery

Order of the list. Default: `newest`.

one of: title, newest, popular

limitintegeroptionalquery

Items per page, 1 to 500. Default: 100.

≥ 1 · ≤ 500

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.

min 1 chars · max 1000 chars

Response fields
35

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

Releases on this page.

dataalbums[]id
integer

Album id.

dataalbums[]title
string

Album title.

dataalbums[]url
stringnullable

Album page URL.

Picture URLs in four sizes.

dataalbums[]imagesid
stringnullable

Image identifier; every size URL is built from it. Null when the item has no picture of its own.

dataalbums[]imagessmall
stringnullable

Small image URL (about 56 px).

dataalbums[]imagesmedium
stringnullable

Medium image URL (about 250 px).

dataalbums[]imagesbig
stringnullable

Large image URL (about 500 px).

dataalbums[]imagesxl
stringnullable

Extra-large image URL (about 1000 px).

dataalbums[]recordType
stringnullable

Release type.

one of: album, ep, single, compilation, null

dataalbums[]releasedAt
stringnullable

Release date. Deezer's original release date when it gives one, otherwise its release date. (YYYY-MM-DD).

dataalbums[]trackCount
integernullable

Number of tracks.

dataalbums[]fanCount
integernullable

Number of fans; null when the record does not carry one.

dataalbums[]explicit
booleannullable

Whether the album is marked explicit.

The main artist.

dataalbums[]artistid
integer

Artist id.

dataalbums[]artistname
string

Artist name.

dataalbums[]artisturl
stringnullable

Artist page URL.

Picture URLs in four sizes.

dataalbums[]artistimagesid
stringnullable

Image identifier; every size URL is built from it. Null when the item has no picture of its own.

dataalbums[]artistimagessmall
stringnullable

Small image URL (about 56 px).

dataalbums[]artistimagesmedium
stringnullable

Medium image URL (about 250 px).

dataalbums[]artistimagesbig
stringnullable

Large image URL (about 500 px).

dataalbums[]artistimagesxl
stringnullable

Extra-large image URL (about 1000 px).

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

datawindowLimited
boolean

True when Deezer stops listing at 500 releases for this combination of filters; narrow the filters (role, type, kind) to reach the rest.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/deezer/artists/27/albums" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Artist's releases.