# Deezer API — music catalogue: tracks with ISRC & BPM, albums with UPC, artists with fan counts, playlists, country charts, credits, podcasts

> Search Deezer's catalogue. `type` = track (default), album, artist, playlist, user, radio or podcast. Tracks can be filtered by record label, duration (seconds) and BPM; when a filter is set Deezer ignores the search words and returns the most popular matching tracks of the whole catalogue (measured: 'metallica', 'love' and 'night' gave the same rows). Up to 100 rows per call; Deezer stops every search at 300 results (total ≤ 300, rows past index 300 are not served). Deezer re-ranks between requests, so consecutive pages can repeat a few tracks (measured: 1 and 3 repeats across pages of 25 for 'love'); one page of up to 100 never repeats. `bpm_max` also matches tracks whose BPM Deezer does not know (bpm 0).
> ReefAPI engine `deezer` · 27 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/deezer/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/deezer/v1/search — 2 credits
Search Deezer's catalogue. `type` = track (default), album, artist, playlist, user, radio or podcast. Tracks can be filtered by record label, duration (seconds) and BPM; when a filter is set Deezer ignores the search words and returns the most popular matching tracks of the whole catalogue (measured: 'metallica', 'love' and 'night' gave the same rows). Up to 100 rows per call; Deezer stops every search at 300 results (total ≤ 300, rows past index 300 are not served). Deezer re-ranks between requests, so consecutive pages can repeat a few tracks (measured: 1 and 3 repeats across pages of 25 for 'love'); one page of up to 100 never repeats. `bpm_max` also matches tracks whose BPM Deezer does not know (bpm 0).

**Parameters:**
- `query` (string, optional) — Search words. Required unless a track filter is given.
- `type` (enum, optional, default "track") — What to search. Plural forms are accepted. [one of: track, album, artist, playlist, user, radio, podcast]
- `label` (string, optional) — type=track only: the record label must match this.
- `dur_min` (integer, optional) — type=track only: minimum length, seconds.
- `dur_max` (integer, optional) — type=track only: maximum length, seconds.
- `bpm_min` (integer, optional) — type=track only: minimum BPM.
- `bpm_max` (integer, optional) — type=track only: maximum BPM (also matches tracks with unknown BPM).
- `index` (integer, optional, default 0) — 0-based position of the first row (use `next_index` of the previous page).
- `limit` (integer, optional, default 25) — Rows per call, 1-100.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** results[] (track rows: id, readable, title, title_short, title_version, isrc, link, share, duration (s), track_position, disk_number, rank, release_date, explicit_lyrics, explicit_content_lyrics, explicit_content_cover, preview (30 s MP3); album / artist / playlist / user / radio / podcast rows as Deezer publishes them) + count + total + index + limit + has_more + next_index + type + query_sent

**Example request body:**
```json
{
  "query": "daft punk"
}
```

### POST https://api.reefapi.com/deezer/v1/search_all — 2 credits
Deezer's own all-in-one search page for a query: the top result plus artists, albums, tracks, playlists, user profiles, podcasts, podcast episodes, live radio streams and radios in one call (up to 20 rows per section, up to 100 tracks). It is a first page only: the page's per-section counters grow with the page size, so they are not returned; use `search` with a `type` for the real total and paging. Fields keep Deezer's web names in lower case (art_id, sng_title, nb_fan …) and every row gets `id`, `url` and `picture_url`.

**Parameters:**
- `query` (string, required) — Search words.
- `tracks_limit` (integer, optional, default 20) — Rows in the tracks section, 1-100. The other sections always hold Deezer's first 20 rows.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** query + fuzziness + autocorrect + section_order[] + top_result[] + artists + albums + tracks + playlists + users + podcasts + episodes + livestreams + radios + channels + lyrics (each {results[], count})

**Example request body:**
```json
{
  "query": "daft punk"
}
```

### POST https://api.reefapi.com/deezer/v1/autocomplete — 2 credits
The search-box suggestions Deezer shows while typing (artist and artist – album completions).

**Parameters:**
- `query` (string, required) — What the user has typed so far.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** query + suggestions[]{query, highlight} + count

**Example request body:**
```json
{
  "query": "daft punk"
}
```

### POST https://api.reefapi.com/deezer/v1/artist — 2 credits
One artist: name, Deezer fan count (`nb_fan`), number of albums, pictures, radio flag, plus MusicBrainz id, country, official website, artist type code and Deezer's artist rank.

**Parameters:**
- `artist_id` (string, required) — Numeric Deezer artist id, or its deezer.com URL.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** id, name, link, share, picture_* , nb_album, nb_fan, radio, tracklist, type + mbid, country, website, birthday, artist_type_code, artist_rank, label_id, smartradio

**Example request body:**
```json
{
  "artist_id": "27"
}
```

### POST https://api.reefapi.com/deezer/v1/artist_bio — 3 credits
The artist page's extra content: biography text and summary with its source, website, Twitter and Facebook links, the highlighted release, the playlists Deezer's editors made for the artist (0-2 measured), the first 12 related playlists (total 100; `artist_playlists` pages them), the 6 related artists the page shows with fan counts (total 20; `artist_related` returns all 20), videos and the artist name in other scripts. Bio text was present for 11 of 12 artists checked. Heavier call (the page is ~1 MB).

**Parameters:**
- `artist_id` (string, required) — Numeric Deezer artist id, or its deezer.com URL.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** artist_id, name, url, picture_url, nb_fan, bio, bio_summary, bio_source, website, twitter, facebook, highlight{}, artist_playlists{results[], total}, related_playlists{results[], total}, related_artists{results[], total}, videos{}, localized_names{}

**Example request body:**
```json
{
  "artist_id": "27"
}
```

### POST https://api.reefapi.com/deezer/v1/artist_top_tracks — 2 credits
The artist's most popular tracks on Deezer, most popular first (Deezer serves at most 100).

**Parameters:**
- `artist_id` (string, required) — Numeric Deezer artist id, or its deezer.com URL.
- `index` (integer, optional, default 0) — 0-based position of the first row (use `next_index` of the previous page).
- `limit` (integer, optional, default 25) — Rows per call, 1-100.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** results[] + count + total + index + limit + has_more + next_index; rows: id, title, isrc, duration, rank, preview, contributors[], album{}

**Example request body:**
```json
{
  "artist_id": "27"
}
```

### POST https://api.reefapi.com/deezer/v1/artist_albums — 2 credits
The artist's discography (albums, EPs, singles, compilations) with release date, record type, fans and explicit flags.

**Parameters:**
- `artist_id` (string, required) — Numeric Deezer artist id, or its deezer.com URL.
- `index` (integer, optional, default 0) — 0-based position of the first row (use `next_index` of the previous page).
- `limit` (integer, optional, default 25) — Rows per call, 1-100.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** results[] + count + total + index + limit + has_more + next_index; rows: id, title, link, cover_*, genre_id, fans, release_date, record_type, explicit_lyrics

**Example request body:**
```json
{
  "artist_id": "27"
}
```

### POST https://api.reefapi.com/deezer/v1/artist_related — 2 credits
Similar artists Deezer recommends for the artist, with fan counts (Deezer returns 20).

**Parameters:**
- `artist_id` (string, required) — Numeric Deezer artist id, or its deezer.com URL.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** results[]{id, name, link, picture_*, nb_album, nb_fan, radio} + count + total

**Example request body:**
```json
{
  "artist_id": "27"
}
```

### POST https://api.reefapi.com/deezer/v1/artist_radio — 2 credits
Deezer's artist mix: tracks by the artist and similar artists (a fresh mix on each call).

**Parameters:**
- `artist_id` (string, required) — Numeric Deezer artist id, or its deezer.com URL.
- `limit` (integer, optional, default 25) — Tracks, 1-100.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** results[] (track rows) + count

**Example request body:**
```json
{
  "artist_id": "27"
}
```

### POST https://api.reefapi.com/deezer/v1/artist_playlists — 2 credits
Public playlists that feature the artist, with track counts and their creator (Deezer lists at most 100).

**Parameters:**
- `artist_id` (string, required) — Numeric Deezer artist id, or its deezer.com URL.
- `index` (integer, optional, default 0) — 0-based position of the first row (use `next_index` of the previous page).
- `limit` (integer, optional, default 25) — Rows per call, 1-100.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** results[] + count + total + index + limit + has_more + next_index; rows: id, title, public, nb_tracks, link, picture_*, creation_date, user{}

**Example request body:**
```json
{
  "artist_id": "27"
}
```

### POST https://api.reefapi.com/deezer/v1/album — 2 credits
One album by id or by UPC barcode: title, UPC, label, genres, record type, release date, original / physical / digital release dates, copyright, number of tracks and discs, total duration, fans, contributors and its tracklist with ISRCs. Where the requested release is not licensed in the chosen country Deezer serves another release instead; it is returned with `market_substitute: true` and `requested_id`.

**Parameters:**
- `album_id` (string, optional) — Numeric Deezer album id, or its deezer.com URL.
- `upc` (string, optional) — Album UPC / EAN barcode instead of album_id.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** id, title, upc, link, cover_*, genre_id, genres[], label, nb_tracks, duration, fans, release_date, record_type, available, explicit_*, contributors[], artist{}, tracks{data[]} + copyright, original_release_date, physical_release_date, digital_release_date, disk_count, album_rank, artist_rank, market_substitute, requested_id (only when substituted)

**Example request body:**
```json
{
  "album_id": "302127"
}
```

### POST https://api.reefapi.com/deezer/v1/album_tracks — 2 credits
The album's tracklist page by page: ISRC, position, disc, duration, rank, preview.

**Parameters:**
- `album_id` (string, required) — Numeric Deezer album id, or its deezer.com URL.
- `index` (integer, optional, default 0) — 0-based position of the first row (use `next_index` of the previous page).
- `limit` (integer, optional, default 25) — Rows per call, 1-100.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** results[] + count + total + index + limit + has_more + next_index; rows: id, title, isrc, track_position, disk_number, duration, rank, preview, artist{}

**Example request body:**
```json
{
  "album_id": "302127"
}
```

### POST https://api.reefapi.com/deezer/v1/track — 2 credits
One track by id or ISRC: title, ISRC, BPM, gain, duration, rank, release date, 30-second preview URL, explicit flags, the countries it is available in, contributors, album and artist; plus credits by role (composer, author, producer, mixing and mastering engineers …), copyright, physical release date, streaming rights and the other releases of the same recording. `rank` (Deezer's popularity score) follows the market: one track read 916,669 in us and 948,951 in gb in the same minutes. A market substitute is marked as for `album`.

**Parameters:**
- `track_id` (string, optional) — Numeric Deezer track id, or its deezer.com URL.
- `isrc` (string, optional) — Track ISRC instead of track_id.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** id, readable, title, title_short, title_version, isrc, link, share, duration (s), track_position, disk_number, rank, release_date, explicit_lyrics, explicit_content_lyrics, explicit_content_cover, preview (30 s MP3), bpm, gain, available_countries[], contributors[]{id, name, role, picture_*}, md5_image, artist{}, album{}, available_country_count + credits{role: [names]}, copyright, physical_release_date, has_lyrics, streaming_rights{}, countries_free_with_ads[], countries_subscription_only[], updated_at, file_sizes{}, rank_web_page, other_releases[], market_substitute, requested_id (only when substituted)

**Example request body:**
```json
{
  "isrc": "GBDUW0000059"
}
```

### POST https://api.reefapi.com/deezer/v1/playlist — 2 credits
One public playlist: title, description, number of tracks, total duration, fans, creator, creation and last-change dates, plus its first tracks (with date added).

**Parameters:**
- `playlist_id` (string, required) — Numeric Deezer playlist id, or its deezer.com URL.
- `tracks_limit` (integer, optional, default 25) — How many of the first tracks to include, 1-100 (page through the rest with playlist_tracks).
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** id, title, description, duration, public, collaborative, nb_tracks, fans, link, picture_*, checksum, creation_date, add_date, mod_date, creator{id, name}, tracks{results[] with time_add, count}

**Example request body:**
```json
{
  "playlist_id": "908622995"
}
```

### POST https://api.reefapi.com/deezer/v1/playlist_tracks — 2 credits
Every track of a playlist page by page, with the date each was added (`time_add`, Unix time).

**Parameters:**
- `playlist_id` (string, required) — Numeric Deezer playlist id, or its deezer.com URL.
- `index` (integer, optional, default 0) — 0-based position of the first row (use `next_index` of the previous page).
- `limit` (integer, optional, default 25) — Rows per call, 1-100.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** results[] + count + total + index + limit + has_more + next_index; rows: id, title, isrc, duration, rank, preview, time_add, artist{}, album{}

**Example request body:**
```json
{
  "playlist_id": "908622995"
}
```

### POST https://api.reefapi.com/deezer/v1/chart — 2 credits
Deezer's chart for a country (the `country` market) — overall or for one genre. type=all returns the top 10 of tracks, albums, artists, playlists and podcasts; a single type pages up to 300 tracks / 300 albums / 100 artists / 100 playlists / 100 podcasts with their chart position. `country.served` is the country Deezer said it served. Rows of playlists and podcasts carry no chart position from Deezer; their place in the list is added (`position_source: order`).

**Parameters:**
- `type` (enum, optional, default "all") — Which chart. Singular forms are accepted. [one of: all, tracks, albums, artists, playlists, podcasts]
- `genre_id` (string, optional, default "0") — 0 = all genres (default); a genre id from `genres` for that genre's chart.
- `index` (integer, optional, default 0) — 0-based position of the first row (use `next_index` of the previous page).
- `limit` (integer, optional, default 25) — Rows per call, 1-300.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** country{requested, served, name, deezer_open} + genre_id + type + (type=all: tracks, albums, artists, playlists, podcasts each {results[], count}) or (results[] with position + position_source, count, index, limit, has_more, next_index, chart_ceiling; total is null: Deezer publishes no chart size)

**Example request body:**
```json
{
  "type": "tracks",
  "limit": 50,
  "country": "gb"
}
```

### POST https://api.reefapi.com/deezer/v1/genres — 2 credits
All Deezer music genres with their ids (the ids `chart`, `genre` and `editorial` take).

**Parameters:**
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** results[]{id, name, picture_*} + count

**Example request body:**
```json
{
  "country": "gb"
}
```

### POST https://api.reefapi.com/deezer/v1/genre — 2 credits
One genre: name and picture, its popular artists and its radios (mixes).

**Parameters:**
- `genre_id` (string, required) — Numeric Deezer genre id (0 = all, 132 = Pop, 116 = Rap/Hip Hop …; list them with `genres`).
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** genre{id, name, picture_*} + artists{results[], count} + radios{results[], count}

**Example request body:**
```json
{
  "genre_id": "132"
}
```

### POST https://api.reefapi.com/deezer/v1/radios — 2 credits
Deezer's radios (genre / mood / decade mixes): every radio (view=all), radios grouped by genre (view=by_genre) or the paged radio lists (view=lists).

**Parameters:**
- `view` (enum, optional, default "all") — Which radio listing. [one of: all, by_genre, lists]
- `index` (integer, optional, default 0) — 0-based position of the first row (use `next_index` of the previous page).
- `limit` (integer, optional, default 25) — Rows per call, 1-100.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** view=all|by_genre: results[] + count; view=lists: results[] + count + total + index + limit + has_more + next_index

**Example request body:**
```json
{
  "index": 0
}
```

### POST https://api.reefapi.com/deezer/v1/radio — 2 credits
One radio (mix): title, description, picture and its current tracks.

**Parameters:**
- `radio_id` (string, required) — Numeric Deezer radio id, or its deezer.com URL.
- `limit` (integer, optional, default 25) — Tracks, 1-100.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** radio{id, title, description, share, picture_*} + tracks{results[], count}

**Example request body:**
```json
{
  "radio_id": "37151"
}
```

### POST https://api.reefapi.com/deezer/v1/editorials — 2 credits
Deezer's editorial sections (one per genre, 0 = all).

**Parameters:**
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** results[]{id, name, picture_*} + count

**Example request body:**
```json
{
  "country": "gb"
}
```

### POST https://api.reefapi.com/deezer/v1/editorial — 2 credits
One editorial section and the albums Deezer's editors currently select for it.

**Parameters:**
- `editorial_id` (string, required) — Numeric Deezer editorial id (0 = all; the ids are the genre ids; list with `editorials`).
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** editorial{id, name, picture_*} + selection{results[] (albums), count}

**Example request body:**
```json
{
  "editorial_id": "0"
}
```

### POST https://api.reefapi.com/deezer/v1/user — 2 credits
A public Deezer user profile: name, country, pictures and link.

**Parameters:**
- `user_id` (string, required) — Numeric Deezer user (profile) id, or its deezer.com URL.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** id, name, link, picture_*, country, tracklist, type

**Example request body:**
```json
{
  "user_id": "2529"
}
```

### POST https://api.reefapi.com/deezer/v1/user_list — 2 credits
A public list of a user: playlists, favourite albums, favourite artists, favourite tracks, followings, followers, charts (the user's most played tracks), podcasts or flow (the user's personal mix). Followers / followings pages can hold fewer rows than `limit` (Deezer skips hidden profiles); use `next_index`.

**Parameters:**
- `user_id` (string, required) — Numeric Deezer user (profile) id, or its deezer.com URL.
- `section` (enum, required) — Which list. [one of: playlists, albums, artists, tracks, followings, followers, charts, podcasts, flow]
- `index` (integer, optional, default 0) — 0-based position of the first row (use `next_index` of the previous page).
- `limit` (integer, optional, default 25) — Rows per call, 1-100.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** results[] + count + total + index + limit + has_more + next_index + section

### POST https://api.reefapi.com/deezer/v1/podcast — 2 credits
One podcast (show): title, description, availability, fans, link and pictures.

**Parameters:**
- `podcast_id` (string, required) — Numeric Deezer podcast (show) id, or its deezer.com URL.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** id, title, description, available, fans, link, share, picture_*, type

**Example request body:**
```json
{
  "podcast_id": "4524137"
}
```

### POST https://api.reefapi.com/deezer/v1/podcast_episodes — 2 credits
A podcast's episodes, newest first, page by page.

**Parameters:**
- `podcast_id` (string, required) — Numeric Deezer podcast (show) id, or its deezer.com URL.
- `index` (integer, optional, default 0) — 0-based position of the first row (use `next_index` of the previous page).
- `limit` (integer, optional, default 25) — Rows per call, 1-100.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** results[] + count + total + index + limit + has_more + next_index; rows: id, title, release_date, duration, picture

**Example request body:**
```json
{
  "podcast_id": "4524137"
}
```

### POST https://api.reefapi.com/deezer/v1/episode — 2 credits
One podcast episode: title, description, release date, duration, availability and its podcast.

**Parameters:**
- `episode_id` (string, required) — Numeric Deezer podcast episode id, or its deezer.com URL.
- `country` (string, optional, default "gb") — 2-letter country code of the Deezer market to read from (gb, us, fr, de, br, mx, tr, jp …). Decides the chart country and which tracks Deezer shows: it hides tracks not licensed in that market from lists (search 'metallica' in us: 1 row of 25, in gb and fr: 25 of 25). Default gb.

**Returns:** id, title, description, available, release_date, duration, link, share, picture_*, podcast{}

**Example request body:**
```json
{
  "episode_id": "963947141"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=deezer
- Human docs page: https://reefapi.com/docs/deezer
- Overview page: https://reefapi.com/deezer-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
