Social Fetch
Start for freeStart free
Deezer hub

Deezer Album API

The album record and its ordered tracklist, in one response.

GET /v1/deezer/albums/{albumId}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/deezer/albums/{albumId} returns lookupStatus, requestedId and album. The album carries title, upc, label, recordType, releasedAt, originalReleasedAt, durationMs, trackCount, fanCount, genres, primaryGenreId, artists, credits, copyright, subtypes, tracks and tracksComplete.

releasedAt is the original release date when Deezer gives one, otherwise the release date, so the batch and discography routes use the same meaning. originalReleasedAt is the original date when Deezer gives one. subtypes is null when the album record does not report a subtype; the batch route fills it from the album query. requestedId matters when Deezer has retired an id in favour of a replacement: it is the id you asked for, while album.id is the album that answered. A very large album is bounded to 2,000 track rows and tracksComplete is false when some are missing.

Deezer Album 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.

Why does requestedId differ from album.id?

Deezer can retire an album id and point it at a replacement. requestedId is the id you sent and album.id is the album that answered, so both values stay visible.

Is the full tracklist always returned?

Up to 2,000 track rows. tracksComplete is true when every track is present and false when the album is larger than that bound or a page lost rows.

Other Deezer endpoints