Deezer Albums Batch API
Hydrate a list of album ids with order kept and unknown ids reported.
GET /v1/deezer/albums1 credit per id Up to 200 ids per request Max 200 credits An id Deezer does not know is still charged Failed requests are free
About this endpoint
GET /v1/deezer/albums?ids=302127,6575789 takes up to 200 album ids and returns requested, albums in the order asked for and notFoundIds. Each album adds label, mostPopularTrackId, subtypes, hasAiContent, isDolbyAtmos, isExclusive, copyright and durationMs to the list album shape. releasedAt is the original release date when Deezer gives one, otherwise the release date.
The batch is lighter than one album lookup per id: it returns album records, not full tracklists. Use the single album route when you need every track.
Deezer Albums Batch API FAQ
How much does a batch 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.
Does a batch return tracklists?
No. It returns album records. Use GET /v1/deezer/albums/{albumId} for an album with its tracklist and tracksComplete.
How are unknown ids handled?
They are listed in data.notFoundIds. Found albums keep the order you asked for, and a duplicate id is counted once.
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}
- ArtistGET /v1/deezer/artists/{artistId}
- Artists batchGET /v1/deezer/artists