Get Deezer album
Get a Deezer album with its label, barcode, copyright lines, credits and every track.
Headers
Get your API keyAPI key (`sfk_...`)
Deezer album id, for example `302127`.
pattern: ^[1-9]\d{0,11}$
Two-letter language code for editorial text, such as `fr`. Titles and names are not translated. Default: `en`.
pattern: ^[a-z]{2}$
Endpoint-specific response payload.
Whether the item was found.
one of: found, not_found
The album id asked for. It differs from `album.id` when Deezer has retired the id in favour of a replacement album.
The album when found; otherwise null.
Album id.
Album title.
Album page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Release type.
one of: album, ep, single, compilation, null
Release date. Deezer's original release date when it gives one, otherwise its release date. (YYYY-MM-DD).
Number of tracks.
Number of fans; null when the record does not carry one.
Whether the album is marked explicit.
The main artist.
Artist id.
Artist name.
Artist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Universal Product Code (barcode).
Record label.
Total duration in milliseconds.
Original release date, when Deezer gives one. (YYYY-MM-DD).
Physical release date. (YYYY-MM-DD).
Kinds of release Deezer assigns to the album. Null when the album record does not report a subtype; the batch lookup reports the flags.
Studio album.
Live album.
Compilation.
Karaoke album.
Genres Deezer assigns.
Genre id.
Genre name.
Id of the album's main genre.
Deezer's explicit-content codes.
Deezer's explicit-lyrics code: 0 not explicit, 1 explicit, 2 unknown, and other values on albums (4, 6, 7) that mix tracks.
Deezer's explicit-cover code: 0 not explicit, 1 explicit.
Whether the album is available.
Copyright line.
Phonogram (sound recording) copyright line.
Every artist credited on the album.
Artist id.
Artist name.
Artist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
How the artist is credited on the item: `main`, `featured`, or the credit as Deezer words it.
People credited on the album, grouped by role.
The credit role as Deezer words it, for example `main_artist`, `composer`, `author` or `mastering engineer`. Roles are free text and spelled inconsistently.
People credited in this role.
The album's tracks, in order. A very large album is bounded to 2,000 rows; `tracksComplete` says whether every track is here.
Track id.
Track title, version included.
Track title without the version.
Version label such as `(Radio Edit)`; null for most tracks.
International Standard Recording Code.
Track page URL.
Duration in milliseconds.
Position on the disc.
Disc number.
Deezer's popularity score for the track.
Whether the lyrics are marked explicit.
Whether Deezer can play the track in its catalogue.
A 30 second audio preview. The link is signed and stops working about 15 minutes after the response.
When the preview link stops working (ISO-8601, UTC).
When the track was added to the playlist; null outside playlists (ISO-8601, UTC).
The main artist.
Artist id.
Artist name.
Artist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
The album.
Album id.
Album title.
Album page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Whether `tracks` holds every track. False when the album has more tracks than the 2,000-row bound, or a page lost rows.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/deezer/albums/302127" \
-H "x-api-key: YOUR_API_KEY"Responses
Deezer album.