Deezer

Get Deezer page embed

Get the embed code and thumbnail for a Deezer track, album, playlist, podcast or episode page URL.

GET/v1/deezer/oembed
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
urlstringrequiredquery

A Deezer track, album, playlist, show or episode page URL.

max 300 chars

Response fields
18

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

Deezer's embed for the page; null when not found.

dataembedentity
string

What the URL points at: `track`, `album`, `playlist`, `show` or `episode`.

dataembedid
integer

Id of the item.

dataembedurl
string

Page URL of the item.

dataembedtitle
string

Title of the item.

dataembedauthorName
stringnullable

Artist or publisher name.

dataembedthumbnailUrl
stringnullable

Thumbnail image URL.

dataembedthumbnailWidth
integernullable

Thumbnail width in pixels.

dataembedthumbnailHeight
integernullable

Thumbnail height in pixels.

dataembedhtml
string

Embed code: an iframe that loads Deezer's own player.

dataembedwidth
integernullable

Embed width in pixels.

dataembedheight
integernullable

Embed height in pixels.

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/oembed?url=https://www.deezer.com/track/3135556" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Embed of a Deezer page.