Deezer

Get several Deezer albums

Get up to 200 Deezer albums in one request; ids that match nothing are listed.

GET/v1/deezer/albums
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
idsarrayrequiredquery

Comma-separated Deezer album ids, 1 to 200.

Response fields
45

Endpoint-specific response payload.

datarequested
integer

Number of distinct ids asked for.

Albums found, in the order asked for.

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).

dataalbums[]label
stringnullable

Record label.

dataalbums[]mostPopularTrackId
integernullable

Id of the album's most played track.

Kinds of release Deezer assigns to the album. Null when the record does not report a subtype.

dataalbums[]subtypesstudio
boolean

Studio album.

dataalbums[]subtypeslive
boolean

Live album.

dataalbums[]subtypescompilation
boolean

Compilation.

dataalbums[]subtypeskaraoke
boolean

Karaoke album.

dataalbums[]hasAiContent
booleannullable

Whether Deezer flags AI-generated content on the album.

dataalbums[]isDolbyAtmos
booleannullable

Whether the album is available in Dolby Atmos.

dataalbums[]isExclusive
booleannullable

Whether the album is a Deezer exclusive.

dataalbums[]copyright
stringnullable

Copyright line.

dataalbums[]durationMs
integernullable

Total duration in milliseconds.

Ids that matched no album.

datanotFoundIds[]
integeroptional

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/albums?ids=302127,1262014" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Deezer albums.