Deezer API & Scraper
This API reads Deezer's public catalogue as JSON, logged out, in the country you choose (default United Kingdom).
🤖 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.
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.
| Field | What 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. |
| bpm | Beats 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_countries | ISO codes of the countries where the track can be played on Deezer; between 190 and 214 for the 45 tracks checked. |
| credits | Contributors 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. |
| copyright | The ℗ 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_substitute | true 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_served | Rows 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). |
| preview | A 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.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/deezer/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "daft punk"
}
}{
"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"
}
}What the Deezer API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | 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). | Content platforms call search to search Deezer's catalogue. | query, type, label, dur_min, dur_max, ... |
| search_all | 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`. | Research tools call search_all to get deezer's own all-in-one search page for a query. | query, tracks_limit, country |
| autocomplete | The 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 |
| artist | 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. | Media monitors call artist to get one artist. | artist_id, country |
| artist_bio | 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). | Content platforms call artist_bio to get the artist page's extra content. | artist_id, country |
| artist_top_tracks | The 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_albums | The 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_related | Similar 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_radio | Deezer'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_playlists | Public 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 |
| album | 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`. | Community analysts call album to get one album by id or by UPC barcode. | album_id, upc, country |
| album_tracks | The 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 |
| track | 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`. | Content platforms call track to get one track by id or ISRC. | track_id, isrc, country |
| playlist | One 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_tracks | Every 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 |
| chart | 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`). | Media monitors call chart to get deezer's chart for a country (the `country` market). | type, genre_id, index, limit, country |
| genres | All 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 |
| genre | One genre: name and picture, its popular artists and its radios (mixes). | Research tools call genre to get one genre. | genre_id, country |
| radios | 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). | Community analysts call radios to get deezer's radios (genre / mood / decade mixes). | view, index, limit, country |
| radio | One radio (mix): title, description, picture and its current tracks. | Media monitors call radio to get one radio (mix). | radio_id, limit, country |
| editorials | Deezer's editorial sections (one per genre, 0 = all). | Content platforms call editorials to get deezer's editorial sections (one per genre, 0 = all).. | country |
| editorial | One 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 |
| user | A public Deezer user profile: name, country, pictures and link. | Community analysts call user to get a public Deezer user profile. | user_id, country |
| user_list | 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`. | Media monitors call user_list to get a public list of a user. | user_id, section, index, limit, country |
| podcast | One podcast (show): title, description, availability, fans, link and pictures. | Content platforms call podcast to get one podcast (show). | podcast_id, country |
| podcast_episodes | A 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 |
| episode | One podcast episode: title, description, release date, duration, availability and its podcast. | Community analysts call episode to get one podcast episode. | episode_id, country |
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"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/deezer/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "daft punk"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/deezer/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "daft punk"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.deezer.search with {"query":"daft punk"}.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.
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.