Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Deezer API page →
Media, Film & Knowledge

Deezer API & Scraper

This API reads Deezer's public catalogue as JSON, logged out, in the country you choose (default United Kingdom).

27 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

`track` takes a Deezer id or an ISRC and returns the ISRC, BPM, replay gain, duration, Deezer rank, release date, the 30-second preview link, the countries where it can be played, every contributor, the credits by role (composer, author, producer, mixing and mastering engineer…), the copyright line, streaming rights and the other releases of the same recording. `album` takes an id or a UPC barcode and returns label, genres, record type, release, original and physical release dates, copyright, number of tracks and discs, fans and the tracklist with ISRCs. `artist` returns the Deezer fan count, number of albums, MusicBrainz id, country and website; `artist_bio` adds the biography and social links; top tracks (100), discography, related artists (20), the artist mix and playlists featuring the artist have their own calls. `chart` returns Deezer's chart for the country you name, overall or for one genre: up to 300 tracks or albums and 100 artists, playlists or podcasts, each with its position, and it reports which country Deezer served. `search` covers tracks, albums, artists, playlists, users, radios and podcasts with label, duration and BPM filters for tracks; `search_all` is Deezer's all-in-one results page. Playlists with every track, public user profiles and their lists, genres, radios, editorial picks, podcasts and episodes complete it.

Reference

What a Deezer field actually contains

Fields that read differently from how they look. Every row was measured against live Deezer on 2026-11-16.

FieldWhat it holds
nb_fan (artist)Deezer users who added the artist to their favourites (Daft Punk: 5,238,940). It equalled the fan count on the artist's deezer.com page for 8 of 8 artists checked in the same minute.
rank (track)Deezer's popularity score for the track, not a chart position (Harder, Better, Faster, Stronger: 810,329). It equalled the value on the track's deezer.com page for 6 of 6 tracks. It can differ by country: one track read 916,669 in the US and 948,951 in the UK in the same minutes.
bpmBeats per minute as Deezer publishes it, for example 170.84 for Blinding Lights. 0 means Deezer has no BPM for the track: 18 of 45 tracks checked had 0.
available_countriesISO codes of the countries where the track can be played on Deezer; between 190 and 214 for the 45 tracks checked.
creditsContributors by role as Deezer's track page lists them: author on 39 of 45 tracks, composer on 38, mixing engineer on 15, mastering engineer on 12.
copyrightThe ℗ line. Published on 32 of 45 tracks and 26 of 29 albums checked; null when Deezer shows none.
upc, label, nb_tracks, fans (album)Equal to the album's deezer.com page for 6 of 6 albums checked (Discovery: UPC 724384960650, Daft Life Ltd./ADA France, 14 tracks).
market_substitutetrue when Deezer answered with another release because the requested one is not licensed in the chosen country (Nevermind (Remastered), id 1262014, came back from the US as id 1252978 with another UPC). requested_id then holds the id you asked for.
rows_not_servedRows Deezer counted on a list page but did not serve in that country. Searching "metallica" in the US returned 1 row of 25 (rows_not_served 24); in the UK and France 25 of 25.
position (chart)Place in the chart. Track, album and artist rows carry Deezer's own position; playlist and podcast rows get their place in the list (position_source: order).
previewA 30-second MP3 clip URL. It is signed and expires; full-length audio is not provided.

Data is what Deezer shows a logged-out visitor in the country you pick. Charts, the tracks Deezer lists and which release an id resolves to follow that country; fan counts and ISRCs do not.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/deezer/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "daft punk"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "deezer",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1624.5,
    "record_count": 25,
    "bytes": 53447,
    "cache_hit": false,
    "total": 169,
    "upstream_requests": 2,
    "country_requested": "gb",
    "country_served": "gb",
    "charged_credits": 2,
    "version": "0.1.0",
    "request_id": "5db3e29195b24ebe",
    "queue_ms": 1.3,
    "fetched_at": "2026-11-16T21:05:23.372Z"
  },
  "data": {
    "results": [
      {
        "id": 67238732,
        "readable": true,
        "title": "Instant Crush (feat. Julian Casablancas)",
        "title_short": "Instant Crush",
        "title_version": "(feat. Julian Casablancas)",
        "isrc": "USQX91300105",
        "link": "https://www.deezer.com/track/67238732",
        "duration": 337,
        "rank": 972797,
        "explicit_lyrics": false,
        "explicit_content_lyrics": 0,
        "explicit_content_cover": 0,
        "preview": "https://cdnt-preview.dzcdn.net/api/1/1/d/6/b/0/d6bc80aadfa1d7625d59a6620f229371.mp3?hdnea=exp=1794864023~acl=/api/1/1/d/6/b/0/d6bc80aadfa1d7625d59a6620f229371.mp3*~data=user_id=0,application_id=42~hmac=b6315adb8bd342758526deb61fde76e559b7045d1c5c61c11526fc6bdb6e63c1",
        "md5_image": "311bba0fc112d15f72c8b5a65f0456c1",
        "artist": {
          "id": 27,
          "name": "Daft Punk",
          "link": "https://www.deezer.com/artist/27",
          "picture": "https://api.deezer.com/artist/27/image",
          "picture_small": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/56x56-000000-80-0-0.jpg",
          "picture_medium": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/250x250-000000-80-0-0.jpg",
          "picture_big": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/500x500-000000-80-0-0.jpg",
          "picture_xl": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg",
          "tracklist": "https://api.deezer.com/artist/27/top?limit=50",
          "type": "artist"
        },
        "album": {
          "id": 6575789,
          "title": "Random Access Memories",
          "cover": "https://api.deezer.com/album/6575789/image",
          "cover_small": "https://cdn-images.dzcdn.net/images/cover/311bba0fc112d15f72c8b5a65f0456c1/56x56-000000-80-0-0.jpg",
          "cover_medium": "https://cdn-images.dzcdn.net/images/cover/311bba0fc112d15f72c8b5a65f0456c1/250x250-000000-80-0-0.jpg",
          "cover_big": "https://cdn-images.dzcdn.net/images/cover/311bba0fc112d15f72c8b5a65f0456c1/500x500-000000-80-0-0.jpg",
          "cover_xl": "https://cdn-images.dzcdn.net/images/cover/311bba0fc112d15f72c8b5a65f0456c1/1000x1000-000000-80-0-0.jpg",
          "md5_image": "311bba0fc112d15f72c8b5a65f0456c1",
          "tracklist": "https://api.deezer.com/album/6575789/tracks",
          "type": "album"
        },
        "type": "track"
      },
      {
        "id": 136889400,
        "readable": true,
        "title": "Starboy",
        "title_short": "Starboy",
        "title_version": "",
        "isrc": "USUG11600976",
        "link": "https://www.deezer.com/track/136889400",
        "duration": 230,
        "rank": 975897,
        "explicit_lyrics": true,
        "explicit_content_lyrics": 1,
        "explicit_content_cover": 1,
        "preview": "https://cdnt-preview.dzcdn.net/api/1/1/3/c/1/0/3c19a82aeffd2f6f6adb63c4d8548e06.mp3?hdnea=exp=1794864023~acl=/api/1/1/3/c/1/0/3c19a82aeffd2f6f6adb63c4d8548e06.mp3*~data=user_id=0,application_id=42~hmac=09e445d2d31d99a21be00662352004a303b0bc0b3709fc1c62e54049599961a0",
        "md5_image": "134778e4c4f19ea71c82408300925a9a",
        "artist": {
          "id": 4050205,
          "name": "The Weeknd",
          "link": "https://www.deezer.com/artist/4050205",
          "picture": "https://api.deezer.com/artist/4050205/image",
          "picture_small": "https://cdn-images.dzcdn.net/images/artist/581693b4724a7fcfa754455101e13a44/56x56-000000-80-0-0.jpg",
          "picture_medium": "https://cdn-images.dzcdn.net/images/artist/581693b4724a7fcfa754455101e13a44/250x250-000000-80-0-0.jpg",
          "picture_big": "https://cdn-images.dzcdn.net/images/artist/581693b4724a7fcfa754455101e13a44/500x500-000000-80-0-0.jpg",
          "picture_xl": "https://cdn-images.dzcdn.net/images/artist/581693b4724a7fcfa754455101e13a44/1000x1000-000000-80-0-0.jpg",
          "tracklist": "https://api.deezer.com/artist/4050205/top?limit=50",
          "type": "artist"
        },
        "album": {
          "id": 14652356,
          "title": "Starboy",
          "cover": "https://api.deezer.com/album/14652356/image",
          "cover_small": "https://cdn-images.dzcdn.net/images/cover/134778e4c4f19ea71c82408300925a9a/56x56-000000-80-0-0.jpg",
          "cover_medium": "https://cdn-images.dzcdn.net/images/cover/134778e4c4f19ea71c82408300925a9a/250x250-000000-80-0-0.jpg",
          "cover_big": "https://cdn-images.dzcdn.net/images/cover/134778e4c4f19ea71c82408300925a9a/500x500-000000-80-0-0.jpg",
          "cover_xl": "https://cdn-images.dzcdn.net/images/cover/134778e4c4f19ea71c82408300925a9a/1000x1000-000000-80-0-0.jpg",
          "md5_image": "134778e4c4f19ea71c82408300925a9a",
          "tracklist": "https://api.deezer.com/album/14652356/tracks",
          "type": "album"
        },
        "type": "track"
      },
      {
        "id": 66609426,
        "readable": true,
        "title": "Get Lucky (Radio Edit - feat. Pharrell Williams and Nile Rodgers)",
        "title_short": "Get Lucky",
        "title_version": "(Radio Edit - feat. Pharrell Williams and Nile Rodgers)",
        "isrc": "USQX91300809",
        "link": "https://www.deezer.com/track/66609426",
        "duration": 248,
        "rank": 954234,
        "explicit_lyrics": false,
        "explicit_content_lyrics": 0,
        "explicit_content_cover": 0,
        "preview": "https://cdnt-preview.dzcdn.net/api/1/1/1/b/f/0/1bf80a82992903ff685ba1b7275223f8.mp3?hdnea=exp=1794864023~acl=/api/1/1/1/b/f/0/1bf80a82992903ff685ba1b7275223f8.mp3*~data=user_id=0,application_id=42~hmac=abe0fa0348d9bc524434d72f5b96a540c8d25fe3a55fae79f1944797b0e39311",
        "md5_image": "bc49adb87758e0c8c4e508a9c5cce85d",
        "artist": {
          "id": 27,
          "name": "Daft Punk",
          "link": "https://www.deezer.com/artist/27",
          "picture": "https://api.deezer.com/artist/27/image",
          "picture_small": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/56x56-000000-80-0-0.jpg",
          "picture_medium": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/250x250-000000-80-0-0.jpg",
          "picture_big": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/500x500-000000-80-0-0.jpg",
          "picture_xl": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg",
          "tracklist": "https://api.deezer.com/artist/27/top?limit=50",
          "type": "artist"
        },
        "album": {
          "id": 6516139,
          "title": "Get Lucky (Radio Edit - feat. Pharrell Williams and Nile Rodgers)",
          "cover": "https://api.deezer.com/album/6516139/image",
          "cover_small": "https://cdn-images.dzcdn.net/images/cover/bc49adb87758e0c8c4e508a9c5cce85d/56x56-000000-80-0-0.jpg",
          "cover_medium": "https://cdn-images.dzcdn.net/images/cover/bc49adb87758e0c8c4e508a9c5cce85d/250x250-000000-80-0-0.jpg",
          "cover_big": "https://cdn-images.dzcdn.net/images/cover/bc49adb87758e0c8c4e508a9c5cce85d/500x500-000000-80-0-0.jpg",
          "cover_xl": "https://cdn-images.dzcdn.net/images/cover/bc49adb87758e0c8c4e508a9c5cce85d/1000x1000-000000-80-0-0.jpg",
          "md5_image": "bc49adb87758e0c8c4e508a9c5cce85d",
          "tracklist": "https://api.deezer.com/album/6516139/tracks",
          "type": "album"
        },
        "type": "track"
      }
    ],
    "count": 25,
    "total": 169,
    "index": 0,
    "limit": 25,
    "has_more": true,
    "next_index": 25,
    "type": "track",
    "query_sent": "daft punk"
  }
}
Actions

What the Deezer API does

ActionDescriptionConcrete use caseKey params
searchSearch 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).Content platforms call search to search Deezer's catalogue.query, type, label, dur_min, dur_max, ...
search_allDeezer'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`.Research tools call search_all to get deezer's own all-in-one search page for a query.query, tracks_limit, country
autocompleteThe search-box suggestions Deezer shows while typing (artist and artist – album completions).Community analysts call autocomplete to get the search-box suggestions Deezer shows while typing (artist and artist – album completions)..query, country
artistOne 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.Media monitors call artist to get one artist.artist_id, country
artist_bioThe 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).Content platforms call artist_bio to get the artist page's extra content.artist_id, country
artist_top_tracksThe artist's most popular tracks on Deezer, most popular first (Deezer serves at most 100).Research tools call artist_top_tracks to get the artist's most popular tracks on Deezer, most popular first (Deezer serves at most 100)..artist_id, index, limit, country
artist_albumsThe artist's discography (albums, EPs, singles, compilations) with release date, record type, fans and explicit flags.Community analysts call artist_albums to get the artist's discography (albums, EPs, singles, compilations) with release date, record type,….artist_id, index, limit, country
artist_relatedSimilar artists Deezer recommends for the artist, with fan counts (Deezer returns 20).Media monitors call artist_related to get similar artists Deezer recommends for the artist, with fan counts (Deezer.artist_id, country
artist_radioDeezer's artist mix: tracks by the artist and similar artists (a fresh mix on each call).Content platforms call artist_radio to get deezer's artist mix.artist_id, limit, country
artist_playlistsPublic playlists that feature the artist, with track counts and their creator (Deezer lists at most 100).Research tools call artist_playlists to get public playlists that feature the artist, with track counts and their creator (Deezer lists a….artist_id, index, limit, country
albumOne 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`.Community analysts call album to get one album by id or by UPC barcode.album_id, upc, country
album_tracksThe album's tracklist page by page: ISRC, position, disc, duration, rank, preview.Media monitors call album_tracks to get the album's tracklist page by page.album_id, index, limit, country
trackOne 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`.Content platforms call track to get one track by id or ISRC.track_id, isrc, country
playlistOne public playlist: title, description, number of tracks, total duration, fans, creator, creation and last-change dates, plus its first tracks (with date added).Research tools call playlist to get one public playlist.playlist_id, tracks_limit, country
playlist_tracksEvery track of a playlist page by page, with the date each was added (`time_add`, Unix time).Community analysts call playlist_tracks to get every track of a playlist page by page, with the date each was added (`time_add`, Unix time)..playlist_id, index, limit, country
chartDeezer'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`).Media monitors call chart to get deezer's chart for a country (the `country` market).type, genre_id, index, limit, country
genresAll Deezer music genres with their ids (the ids `chart`, `genre` and `editorial` take).Content platforms call genres to get all Deezer music genres with their ids (the ids `chart`, `genre` and `editorial` take)..country
genreOne genre: name and picture, its popular artists and its radios (mixes).Research tools call genre to get one genre.genre_id, country
radiosDeezer's radios (genre / mood / decade mixes): every radio (view=all), radios grouped by genre (view=by_genre) or the paged radio lists (view=lists).Community analysts call radios to get deezer's radios (genre / mood / decade mixes).view, index, limit, country
radioOne radio (mix): title, description, picture and its current tracks.Media monitors call radio to get one radio (mix).radio_id, limit, country
editorialsDeezer's editorial sections (one per genre, 0 = all).Content platforms call editorials to get deezer's editorial sections (one per genre, 0 = all)..country
editorialOne editorial section and the albums Deezer's editors currently select for it.Research tools call editorial to get one editorial section and the albums Deezer's editors currently select for it..editorial_id, country
userA public Deezer user profile: name, country, pictures and link.Community analysts call user to get a public Deezer user profile.user_id, country
user_listA 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`.Media monitors call user_list to get a public list of a user.user_id, section, index, limit, country
podcastOne podcast (show): title, description, availability, fans, link and pictures.Content platforms call podcast to get one podcast (show).podcast_id, country
podcast_episodesA podcast's episodes, newest first, page by page.Research tools call podcast_episodes to get a podcast's episodes, newest first, page by page..podcast_id, index, limit, country
episodeOne podcast episode: title, description, release date, duration, availability and its podcast.Community analysts call episode to get one podcast episode.episode_id, country
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/deezer/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"daft punk"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.deezer.search with {"query":"daft punk"}.
Use cases

Who uses this API and why

  • Match a catalogue by ISRC or UPC and pull Deezer's rank, fans, label, credits and release dates.
  • Track a country's Deezer chart every day, 300 tracks deep, and compare countries.
  • Pull songwriter, composer and producer credits for a recording.
  • Monitor artist fan counts and playlist fans over time.
  • Build tempo-based track lists with BPM and duration filters.
FAQ

Questions developers ask before integrating

Do I need a Deezer account or a Deezer app id?

No. Everything is read logged out; you only need a ReefAPI key.

Can I look a track up by ISRC or an album by UPC?

Yes. track takes isrc (for example GBDUW0000059) and album takes upc (for example 724384960650). Both return the same record as the Deezer id.

Which country's chart do I get?

The one you pass in country as a 2-letter code (default gb). Every response reports the country Deezer served; it matched the request for us, gb, fr, de, br, mx, tr and jp. On the same day the UK #1 was Dracula (with JENNIE), France's Dai Dai and Brazil's Pós (Ao Vivo). Tracks and albums go 300 deep, artists, playlists and podcasts 100.

Why does the same search give fewer results in the US?

Deezer hides tracks that are not licensed in the country you read from: "metallica" returned 1 track in the US and 25 in the UK and France. The response says how many rows Deezer held back (rows_not_served); pick another country to see them.

How deep does search go?

Deezer stops every search at 300 results, up to 100 per call. Deezer can re-rank between requests, so consecutive pages of 25 repeated 1 and 3 tracks in one of our runs and none in another; one page of up to 100 had 100 distinct tracks.

How do the search filters work?

label, dur_min, dur_max, bpm_min and bpm_max filter tracks. When one is set, Deezer ignores the search words and returns the most popular matching tracks of the whole catalogue (the response says so). bpm_max also returns tracks whose BPM Deezer does not know. Deezer's own artist, track and album search operators returned wrong rows in our tests, so they are not offered.

Do you return lyrics or full songs?

No. Deezer does not publish lyrics to logged-out visitors, and full-length audio is out of scope. The 30-second preview link is included.

Can I get every track of a long playlist?

Yes, with playlist_tracks, 100 rows per call: a 1,021-track playlist paged with no gaps or repeats, each row with the date it was added.

What is the Deezer API?

Deezer API is a ReefAPI endpoint group for deezer catalogue as json: tracks by isrc with bpm and credits, albums by upc, artist fan counts, country charts, playlists and podcasts. It returns live JSON through POST requests under /deezer/v1.

Is the Deezer API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Deezer calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Deezer login or account?

No login to Deezer is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Deezer data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Deezer API use?

Deezer actions currently cost 2-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Deezer from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call deezer actions with the same key, credit pool and JSON envelope used by normal REST requests.

docs / deezer

Deezer

Deezer catalogue as JSON: tracks by ISRC with BPM and credits, albums by UPC, artist fan counts, country charts, playlists and podcasts.

base /deezer/v127 endpoints
post/deezer/v1/search_all2 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`.

ParameterAllowed / rangeDescription
queryrequired—Search words.
tracks_limit = 20optional1–100Rows in the tracks section, 1-100. The other sections always hold Deezer's first 20 rows.
country = gboptional—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.
Try in playground →
post/deezer/v1/autocomplete2 credits

The search-box suggestions Deezer shows while typing (artist and artist – album completions).

ParameterAllowed / rangeDescription
queryrequired—What the user has typed so far.
country = gboptional—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.
Try in playground →
post/deezer/v1/artist2 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.

ParameterAllowed / rangeDescription
artist_idrequired—Numeric Deezer artist id, or its deezer.com URL.
country = gboptional—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.
Try in playground →
post/deezer/v1/artist_bio3 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).

ParameterAllowed / rangeDescription
artist_idrequired—Numeric Deezer artist id, or its deezer.com URL.
country = gboptional—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.
Try in playground →
post/deezer/v1/artist_top_tracks2 credits

The artist's most popular tracks on Deezer, most popular first (Deezer serves at most 100).

ParameterAllowed / rangeDescription
artist_idrequired—Numeric Deezer artist id, or its deezer.com URL.
index = 0optional0–0-based position of the first row (use `next_index` of the previous page).
limit = 25optional1–100Rows per call, 1-100.
country = gboptional—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.
Try in playground →
post/deezer/v1/artist_albums2 credits

The artist's discography (albums, EPs, singles, compilations) with release date, record type, fans and explicit flags.

ParameterAllowed / rangeDescription
artist_idrequired—Numeric Deezer artist id, or its deezer.com URL.
index = 0optional0–0-based position of the first row (use `next_index` of the previous page).
limit = 25optional1–100Rows per call, 1-100.
country = gboptional—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.
Try in playground →
post/deezer/v1/artist_radio2 credits

Deezer's artist mix: tracks by the artist and similar artists (a fresh mix on each call).

ParameterAllowed / rangeDescription
artist_idrequired—Numeric Deezer artist id, or its deezer.com URL.
limit = 25optional1–100Tracks, 1-100.
country = gboptional—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.
Try in playground →
post/deezer/v1/artist_playlists2 credits

Public playlists that feature the artist, with track counts and their creator (Deezer lists at most 100).

ParameterAllowed / rangeDescription
artist_idrequired—Numeric Deezer artist id, or its deezer.com URL.
index = 0optional0–0-based position of the first row (use `next_index` of the previous page).
limit = 25optional1–100Rows per call, 1-100.
country = gboptional—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.
Try in playground →
post/deezer/v1/album2 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`.

ParameterAllowed / rangeDescription
album_idoptional—Numeric Deezer album id, or its deezer.com URL.
upcoptional—Album UPC / EAN barcode instead of album_id.
country = gboptional—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.
Try in playground →
post/deezer/v1/album_tracks2 credits

The album's tracklist page by page: ISRC, position, disc, duration, rank, preview.

ParameterAllowed / rangeDescription
album_idrequired—Numeric Deezer album id, or its deezer.com URL.
index = 0optional0–0-based position of the first row (use `next_index` of the previous page).
limit = 25optional1–100Rows per call, 1-100.
country = gboptional—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.
Try in playground →
post/deezer/v1/track2 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`.

ParameterAllowed / rangeDescription
track_idoptional—Numeric Deezer track id, or its deezer.com URL.
isrcoptional—Track ISRC instead of track_id.
country = gboptional—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.
Try in playground →
post/deezer/v1/playlist2 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).

ParameterAllowed / rangeDescription
playlist_idrequired—Numeric Deezer playlist id, or its deezer.com URL.
tracks_limit = 25optional1–100How many of the first tracks to include, 1-100 (page through the rest with playlist_tracks).
country = gboptional—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.
Try in playground →
post/deezer/v1/playlist_tracks2 credits

Every track of a playlist page by page, with the date each was added (`time_add`, Unix time).

ParameterAllowed / rangeDescription
playlist_idrequired—Numeric Deezer playlist id, or its deezer.com URL.
index = 0optional0–0-based position of the first row (use `next_index` of the previous page).
limit = 25optional1–100Rows per call, 1-100.
country = gboptional—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.
Try in playground →
post/deezer/v1/chart2 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`).

ParameterAllowed / rangeDescription
type = alloptionalall · tracks · albums · artists · playlists · podcastsWhich chart. Singular forms are accepted.
genre_id = 0optional—0 = all genres (default); a genre id from `genres` for that genre's chart.
index = 0optional0–0-based position of the first row (use `next_index` of the previous page).
limit = 25optional1–300Rows per call, 1-300.
country = gboptional—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.
Try in playground →
post/deezer/v1/genres2 credits

All Deezer music genres with their ids (the ids `chart`, `genre` and `editorial` take).

ParameterAllowed / rangeDescription
country = gboptional—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.
Try in playground →
post/deezer/v1/genre2 credits

One genre: name and picture, its popular artists and its radios (mixes).

ParameterAllowed / rangeDescription
genre_idrequired—Numeric Deezer genre id (0 = all, 132 = Pop, 116 = Rap/Hip Hop …; list them with `genres`).
country = gboptional—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.
Try in playground →
post/deezer/v1/radios2 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).

ParameterAllowed / rangeDescription
view = alloptionalall · by_genre · listsWhich radio listing.
index = 0optional0–0-based position of the first row (use `next_index` of the previous page).
limit = 25optional1–100Rows per call, 1-100.
country = gboptional—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.
Try in playground →
post/deezer/v1/radio2 credits

One radio (mix): title, description, picture and its current tracks.

ParameterAllowed / rangeDescription
radio_idrequired—Numeric Deezer radio id, or its deezer.com URL.
limit = 25optional1–100Tracks, 1-100.
country = gboptional—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.
Try in playground →
post/deezer/v1/editorials2 credits

Deezer's editorial sections (one per genre, 0 = all).

ParameterAllowed / rangeDescription
country = gboptional—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.
Try in playground →
post/deezer/v1/editorial2 credits

One editorial section and the albums Deezer's editors currently select for it.

ParameterAllowed / rangeDescription
editorial_idrequired—Numeric Deezer editorial id (0 = all; the ids are the genre ids; list with `editorials`).
country = gboptional—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.
Try in playground →
post/deezer/v1/user2 credits

A public Deezer user profile: name, country, pictures and link.

ParameterAllowed / rangeDescription
user_idrequired—Numeric Deezer user (profile) id, or its deezer.com URL.
country = gboptional—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.
Try in playground →
post/deezer/v1/user_list2 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`.

ParameterAllowed / rangeDescription
user_idrequired—Numeric Deezer user (profile) id, or its deezer.com URL.
sectionrequiredplaylists · albums · artists · tracks · followings · followers · charts · podcasts · flowWhich list.
index = 0optional0–0-based position of the first row (use `next_index` of the previous page).
limit = 25optional1–100Rows per call, 1-100.
country = gboptional—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.
Try in playground →
post/deezer/v1/podcast2 credits

One podcast (show): title, description, availability, fans, link and pictures.

ParameterAllowed / rangeDescription
podcast_idrequired—Numeric Deezer podcast (show) id, or its deezer.com URL.
country = gboptional—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.
Try in playground →
post/deezer/v1/podcast_episodes2 credits

A podcast's episodes, newest first, page by page.

ParameterAllowed / rangeDescription
podcast_idrequired—Numeric Deezer podcast (show) id, or its deezer.com URL.
index = 0optional0–0-based position of the first row (use `next_index` of the previous page).
limit = 25optional1–100Rows per call, 1-100.
country = gboptional—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.
Try in playground →
post/deezer/v1/episode2 credits

One podcast episode: title, description, release date, duration, availability and its podcast.

ParameterAllowed / rangeDescription
episode_idrequired—Numeric Deezer podcast episode id, or its deezer.com URL.
country = gboptional—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.
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.