> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/deezer/oembed>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/deezer/oembed.mdx>

---

# Deezer oEmbed API

The embed HTML and thumbnail for a public Deezer page.

`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`.

## Request

- **Endpoint:** `GET /v1/deezer/oembed`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by page URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/deezer/oembed/get)
- **Platform page:** [/platforms/deezer](https://www.socialfetch.dev/platforms/deezer)

## 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.