Deezer oEmbed API
The embed HTML and thumbnail for a public Deezer page.
GET /v1/deezer/oembed1 credit Failed requests are free
About this endpoint
GET /v1/deezer/oembed?url=https://www.deezer.com/track/3135556 returns lookupStatus and embed. The embed carries entity, id, url, title, authorName, thumbnailUrl, thumbnailWidth, thumbnailHeight, html, width and height. The accepted URL is a public track, album, playlist, show or episode page on deezer.com; a language segment such as /fr/ is accepted.
html is an iframe that loads the public player, so it is ready to place in a page. An unknown or unsupported URL returns not_found with embed: null.
Deezer oEmbed 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.
Which URLs are accepted?
A Deezer track, album, playlist, show or episode page URL, for example https://www.deezer.com/track/3135556. A language prefix such as /fr/ is accepted.
Can I use the html directly?
Yes. html is an iframe that loads the public player. Use the width and height fields with it.
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}
- Albums batchGET /v1/deezer/albums
- ArtistGET /v1/deezer/artists/{artistId}