Deezer hub

Deezer Tracks Batch API

Resolve a list of track ids in one call and keep the order you asked for.

GET /v1/deezer/tracks

1 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/tracks?ids=3135556,3135553 takes up to 200 comma separated track ids. The response holds requested, tracks in the order asked for and notFoundIds for ids that matched nothing. The batch response does not carry bpm, copyright, credits, availableCountries, subscriptionOnlyCountries, otherReleases, updatedAt or artist images, so those fields are null or empty. Use the single track lookup when you need them.

Use it to hydrate a saved list of track ids without one request per row. Duplicate ids are counted once, and ids that match nothing are listed rather than silently dropped. The response is HTTP 200 even when some ids are unknown; branch on notFoundIds.

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

How many ids can I send?

One to 200 ids in the ids query parameter, either comma separated or repeated. Duplicates are removed before the lookup.

What happens to an unknown id?

It is listed in data.notFoundIds because the id was part of the request. Read meta.creditsCharged for the charge.