Deezer Track API
One track with its credits, rights, countries and a signed 30 second preview, ready to store or show.
GET /v1/deezer/tracks/{trackId}1 credit Failed requests are free
About this endpoint
GET /v1/deezer/tracks/{trackId} returns data.lookupStatus and data.track. A found track carries title, titleShort, version, isrc, url, durationMs, trackNumber, discNumber, rank, explicit, available and previewUrl with previewExpiresAt. It also carries the main artist and album references, releasedAt, physicalReleasedAt, credits, copyright, otherReleases, availableCountries, subscriptionOnlyCountries, qualities and updatedAt.
Use it when you have a track id from a chart, playlist or search and need the full record rather than the lighter list item. An unknown id returns lookupStatus: not_found with track: null. A track Deezer cannot play still comes back as found with available: false.
Deezer Track 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.
What is in a track response?
On found, data.track holds the title, version, ISRC, duration, track and disc number, rank, explicit flag, preview URL, release dates, artist, album, credits, copyright, other releases, available countries, qualities and updatedAt. data.lookupStatus is found.
How long does previewUrl work?
The preview is a signed 30 second audio link. Its link stops working about 15 minutes after the response, so read previewExpiresAt and fetch the audio before then rather than storing the URL.
Other Deezer endpoints
- 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}
- Albums batchGET /v1/deezer/albums
- ArtistGET /v1/deezer/artists/{artistId}
- Artists batchGET /v1/deezer/artists