Deezer
Search tracks, albums, artists, and playlists on Deezer. Returns metadata + 30s preview URLs.
- Endpoints
- 4
- Requests
- 10
- Updated
- For LLMs
- llms.txt
Endpoint health
searchpassing, 0.5strackpassing, 0.3salbumpassing, 0.3sartistpassing, 0.3s
4/4 passingdaily 01:00 WIB
Playground
4 endpointsGET
/v1/music:deezer/search5m cache4 paramschecking key…Parameters
Response
EXAMPLE
Code examples
Searchzpi-sdkrecommended
// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";
const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });
const data = await client.run("music:deezer", "search", {
"q": "blinding lights",
"type": "track",
"limit": 25,
"page": 1
});
console.log(data);request.sh
curl -X GET "https://api.zpi.web.id/v1/music:deezer/search?q=blinding+lights&type=track&limit=25&page=1" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"Full reference
4 endpoints · plain textGETSearch/v1/music:deezer/searchSearch the catalog by text query.
/v1/music:deezer/searchSearch the catalog by text query.Parameters
qstringrequired- Search query (title, artist, etc)
typeenumoptional- Result type. Default: track Values: track, album, artist, playlist.
limitnumberoptional- Items per page (1-50). Default: 25
pagenumberoptional- Page 1-based. Default: 1
Request
curl -X GET "https://api.zpi.web.id/v1/music:deezer/search?q=blinding+lights&type=track&limit=25&page=1" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"Example response
{
"page": 1,
"count": 231,
"items": [
{
"url": "https://www.deezer.com/track/908604612",
"type": "track",
"album": "After Hours",
"image": "https://cdn-images.dzcdn.net/images/cover/fd00ebd6d30d7253f813dba3bb1c66a9/1000x1000-000000-80-0-0.jpg",
"title": "Blinding Lights",
"artist": {
"id": 4050205,
"url": "https://www.deezer.com/artist/4050205",
"name": "The Weeknd",
"image": "https://cdn-images.dzcdn.net/images/artist/581693b4724a7fcfa754455101e13a44/1000x1000-000000-80-0-0.jpg"
},
"albumId": 137217782,
"preview": "https://cdnt-preview.dzcdn.net/api/1/1/1/b/2/0/1b27825bf63c36edcdc7fac9f920214e.mp3?hdnea=exp=1779796827~acl=/api/1/1/1/b/2/0/1b27825bf63c36edcdc7fac9f920214e.mp3*~data=user_id=0,a…",
"trackId": 908604612,
"playCount": 984833,
"durationMs": 200000,
"isExplicit": false,
"titleShort": "Blinding Lights"
},
{
"url": "https://www.deezer.com/track/920003242",
"type": "track",
"album": "Blinding Lights (Piano Version)",
"image": "https://cdn-images.dzcdn.net/images/cover/a2d59f72801b38f6c1ddb837ef8f5e30/1000x1000-000000-80-0-0.jpg",
"title": "Blinding Lights (Piano Version)",
"artist": {
"id": 87410952,
"url": "https://www.deezer.com/artist/87410952",
"name": "Flying Fingers",
"image": "https://cdn-images.dzcdn.net/images/artist/44a5409bf89e0fc913795fbeee3b8cbd/1000x1000-000000-80-0-0.jpg"
},
"albumId": 139665252,
"preview": "https://cdnt-preview.dzcdn.net/api/1/1/5/c/1/0/5c16c7e688e755f68c370b4f5b908faa.mp3?hdnea=exp=1779796827~acl=/api/1/1/5/c/1/0/5c16c7e688e755f68c370b4f5b908faa.mp3*~data=user_id=0,a…",
"trackId": 920003242,
"playCount": 406652,
"durationMs": 121000,
"isExplicit": false,
"titleShort": "Blinding Lights"
},
{
"url": "https://www.deezer.com/track/851937072",
"type": "track",
"album": "Blinding Lights (Acoustic Version)",
"image": "https://cdn-images.dzcdn.net/images/cover/0395001edac75ba51b1d838ab22bb7e3/1000x1000-000000-80-0-0.jpg",
"title": "Blinding Lights (Acoustic Version)",
"artist": {
"id": 8941068,
"url": "https://www.deezer.com/artist/8941068",
"name": "Victoria Voss",
"image": "https://cdn-images.dzcdn.net/images/artist/5c3a3fe90e8e981d906358791f1ded95/1000x1000-000000-80-0-0.jpg"
},
"albumId": 126616392,
"preview": "https://cdnt-preview.dzcdn.net/api/1/1/e/f/4/0/ef47b0a8d944c98ab5d3862424b338ae.mp3?hdnea=exp=1779796827~acl=/api/1/1/e/f/4/0/ef47b0a8d944c98ab5d3862424b338ae.mp3*~data=user_id=0,a…",
"trackId": 851937072,
"playCount": 625340,
"durationMs": 241000,
"isExplicit": false,
"titleShort": "Blinding Lights"
}
],
"hasMore": true,
"nextPage": 2
}GETTrack Detail/v1/music:deezer/track/:idFetch full metadata for a single track by ID or URL.
/v1/music:deezer/track/:idFetch full metadata for a single track by ID or URL.Parameters
idstringrequiredin path- Track ID (numeric)
Request
curl -X GET "https://api.zpi.web.id/v1/music:deezer/track/916424" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"Example response
{
"bpm": 112.3,
"url": "https://www.deezer.com/track/916424",
"gain": -8.7,
"isrc": "USIR10211038",
"album": "The Eminem Show",
"image": "https://cdn-images.dzcdn.net/images/cover/ec3c8ed67427064c70f67e5815b74cef/1000x1000-000000-80-0-0.jpg",
"title": "Without Me",
"artist": {
"id": 13,
"url": "https://www.deezer.com/artist/13",
"name": "Eminem",
"image": "https://cdn-images.dzcdn.net/images/artist/0f30bbd33a680030054af004d698d6ac/1000x1000-000000-80-0-0.jpg"
},
"albumId": 103248,
"preview": "https://cdnt-preview.dzcdn.net/api/1/1/a/e/b/0/aeb58f2f63ee57fb9c47cbe8fb5ccdaa.mp3?hdnea=exp=1779796832~acl=/api/1/1/a/e/b/0/aeb58f2f63ee57fb9c47cbe8fb5ccdaa.mp3*~data=user_id=0,application_id=42~hmac=1b5985d442f86b28eaa6ac47bfc845bb4a9b542091908208f989b136e684d03c",
"trackId": 916424,
"playCount": 961431,
"diskNumber": 1,
"durationMs": 290000,
"isExplicit": true,
"titleShort": "Without Me",
"releaseDate": "2007-09-13",
"contributors": [
{
"id": 13,
"url": "https://www.deezer.com/artist/13",
"name": "Eminem",
"role": "Main"
}
],
"trackPosition": 10,
"availableCountries": [
"AE",
"AF",
"AG",
"AI",
"AL",
"AM",
"AO",
"AQ",
"AR",
"AS",
"AT",
"AU",
"AZ",
"BA",
"BB",
"BD",
"BE",
"BF",
"BG",
"BH",
"BI",
"BJ",
"BN",
"BO",
"BQ",
"BR",
"BT",
"BV",
"BW",
"BY",
"CA",
"CC",
"CD",
"CF",
"CG",
"CH",
"CI",
"CK",
"CL",
"CM",
"CO",
"CR",
"CU",
"CV",
"CW",
"CX",
"CY",
"CZ",
"DE",
"DJ",
"DK",
"DM",
"DO",
"DZ",
"EC",
"EE",
"EG",
"EH",
"ER",
"ES",
"ET",
"FI",
"FJ",
"FK",
"FM",
"FR",
"GA",
"GB",
"GD",
"GE",
"GH",
"GM",
"GN",
"GQ",
"GR",
"GS",
"GT",
"GU",
"GW",
"HK",
"HM",
"HN",
"HR",
"HU",
"ID",
"IE",
"IL",
"IN",
"IQ",
"IR",
"IS",
"IT",
"JM",
"JO",
"JP",
"KE",
"KG",
"KH",
"KI",
"KM",
"KN",
"KP",
"KR",
"KW",
"KY",
"KZ",
"LA",
"LB",
"LC",
"LK",
"LR",
"LS",
"LT",
"LU",
"LV",
"LY",
"MA",
"MD",
"ME",
"MG",
"MH",
"MK",
"ML",
"MM",
"MN",
"MP",
"MR",
"MS",
"MT",
"MU",
"MV",
"MW",
"MX",
"MY",
"MZ",
"NA",
"NE",
"NF",
"NG",
"NI",
"NL",
"NO",
"NP",
"NR",
"NU",
"NZ",
"OM",
"PA",
"PE",
"PG",
"PH",
"PK",
"PL",
"PN",
"PS",
"PT",
"PW",
"PY",
"QA",
"RO",
"RS",
"RU",
"RW",
"SA",
"SB",
"SC",
"SD",
"SE",
"SG",
"SI",
"SJ",
"SK",
"SL",
"SN",
"SO",
"ST",
"SV",
"SX",
"SY",
"SZ",
"TC",
"TD",
"TG",
"TH",
"TJ",
"TK",
"TL",
"TM",
"TN",
"TO",
"TR",
"TV",
"TZ",
"UA",
"UG",
"US",
"UY",
"UZ",
"VC",
"VE",
"VG",
"VI",
"VN",
"VU",
"WS",
"YE",
"ZA",
"ZM",
"ZW"
]
}GETAlbum Detail/v1/music:deezer/album/:idFetch album info with its tracklist.
/v1/music:deezer/album/:idFetch album info with its tracklist.Parameters
idstringrequiredin path- Album ID (numeric)
Request
curl -X GET "https://api.zpi.web.id/v1/music:deezer/album/302127" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"Example response
{
"upc": "724384960650",
"url": "https://www.deezer.com/album/302127",
"image": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
"label": "Daft Life Ltd./ADA France",
"title": "Discovery",
"artist": {
"id": 27,
"name": "Daft Punk",
"image": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg"
},
"genres": [
{
"id": 106,
"name": "Electro"
}
],
"tracks": [
{
"url": "https://www.deezer.com/track/3135553",
"title": "One More Time",
"artist": {
"id": 27,
"name": "Daft Punk"
},
"preview": "https://cdnt-preview.dzcdn.net/api/1/1/f/8/c/0/f8c5dc3837912dba37c9a1ab3170cc3f.mp3?hdnea=exp=1779796835~acl=/api/1/1/f/8/c/0/f8c5dc3837912dba37c9a1ab3170cc3f.mp3*~data=user_id=0,a…",
"trackId": 3135553,
"playCount": 895695,
"diskNumber": 0,
"durationMs": 320000,
"isExplicit": false,
"titleShort": "One More Time",
"trackPosition": 0
},
{
"url": "https://www.deezer.com/track/3135554",
"title": "Aerodynamic",
"artist": {
"id": 27,
"name": "Daft Punk"
},
"preview": "https://cdnt-preview.dzcdn.net/api/1/1/6/9/9/0/699d41611cf0280f0a55c8ba4a372c14.mp3?hdnea=exp=1779796835~acl=/api/1/1/6/9/9/0/699d41611cf0280f0a55c8ba4a372c14.mp3*~data=user_id=0,a…",
"trackId": 3135554,
"playCount": 767940,
"diskNumber": 0,
"durationMs": 212000,
"isExplicit": false,
"titleShort": "Aerodynamic",
"trackPosition": 0
},
{
"url": "https://www.deezer.com/track/3135555",
"title": "Digital Love",
"artist": {
"id": 27,
"name": "Daft Punk"
},
"preview": "https://cdnt-preview.dzcdn.net/api/1/1/1/e/c/0/1ec8ff31f93acc81ebb93a45c191e219.mp3?hdnea=exp=1779796835~acl=/api/1/1/1/e/c/0/1ec8ff31f93acc81ebb93a45c191e219.mp3*~data=user_id=0,a…",
"trackId": 3135555,
"playCount": 738308,
"diskNumber": 0,
"durationMs": 301000,
"isExplicit": false,
"titleShort": "Digital Love",
"trackPosition": 0
}
],
"albumId": 302127,
"fanCount": 333010,
"durationMs": 3662000,
"isExplicit": false,
"recordType": "album",
"trackCount": 14,
"releaseDate": "2001-03-07",
"contributors": [
{
"id": 27,
"name": "Daft Punk",
"role": "Main"
}
]
}GETArtist Detail/v1/music:deezer/artist/:idFetch artist profile with top tracks and discography.
/v1/music:deezer/artist/:idFetch artist profile with top tracks and discography.Parameters
idstringrequiredin path- Artist ID (numeric)
topLimitnumberoptional- Number of top tracks (1-50). Default: 10
albumLimitnumberoptional- Number of albums (1-50). Default: 25
Request
curl -X GET "https://api.zpi.web.id/v1/music:deezer/artist/27?topLimit=10&albumLimit=25" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"Example response
{
"url": "https://www.deezer.com/artist/27",
"name": "Daft Punk",
"image": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg",
"share": "https://www.deezer.com/artist/27?utm_source=deezer&utm_content=artist-27&utm_term=0_1779795942&utm_medium=web",
"albums": [
{
"url": "https://www.deezer.com/album/494309801",
"image": "https://cdn-images.dzcdn.net/images/cover/bb8b5f188ae380ac3a7c876b70556357/1000x1000-000000-80-0-0.jpg",
"title": "Random Access Memories (Drumless Edition)",
"albumId": 494309801,
"fanCount": 14096,
"isExplicit": false,
"recordType": "album",
"trackCount": 0,
"releaseDate": "2023-11-17"
},
{
"url": "https://www.deezer.com/album/294609352",
"image": "https://cdn-images.dzcdn.net/images/cover/117dcf85bdf0851347403796521d1e9d/1000x1000-000000-80-0-0.jpg",
"title": "Homework (25th Anniversary Edition)",
"albumId": 294609352,
"fanCount": 17045,
"isExplicit": false,
"recordType": "album",
"trackCount": 0,
"releaseDate": "1997-01-20"
},
{
"url": "https://www.deezer.com/album/6575789",
"image": "https://cdn-images.dzcdn.net/images/cover/311bba0fc112d15f72c8b5a65f0456c1/1000x1000-000000-80-0-0.jpg",
"title": "Random Access Memories",
"albumId": 6575789,
"fanCount": 875382,
"isExplicit": false,
"recordType": "album",
"trackCount": 0,
"releaseDate": "2013-05-17"
}
],
"artistId": 27,
"fanCount": 5154880,
"topTracks": [
{
"url": "https://www.deezer.com/track/66609426",
"album": "Get Lucky (Radio Edit - feat. Pharrell Williams and Nile Rodgers)",
"image": "https://cdn-images.dzcdn.net/images/cover/bc49adb87758e0c8c4e508a9c5cce85d/1000x1000-000000-80-0-0.jpg",
"title": "Get Lucky (Radio Edit - feat. Pharrell Williams and Nile Rodgers)",
"albumId": 6516139,
"preview": "https://cdnt-preview.dzcdn.net/api/1/1/1/b/f/0/1bf80a82992903ff685ba1b7275223f8.mp3?hdnea=exp=1779796842~acl=/api/1/1/1/b/f/0/1bf80a82992903ff685ba1b7275223f8.mp3*~data=user_id=0,a…",
"trackId": 66609426,
"playCount": 954234,
"durationMs": 248000,
"isExplicit": false,
"titleShort": "Get Lucky"
},
{
"url": "https://www.deezer.com/track/67238732",
"album": "Random Access Memories",
"image": "https://cdn-images.dzcdn.net/images/cover/311bba0fc112d15f72c8b5a65f0456c1/1000x1000-000000-80-0-0.jpg",
"title": "Instant Crush (feat. Julian Casablancas)",
"albumId": 6575789,
"preview": "https://cdnt-preview.dzcdn.net/api/1/1/d/6/b/0/d6bc80aadfa1d7625d59a6620f229371.mp3?hdnea=exp=1779796842~acl=/api/1/1/d/6/b/0/d6bc80aadfa1d7625d59a6620f229371.mp3*~data=user_id=0,a…",
"trackId": 67238732,
"playCount": 942491,
"durationMs": 337000,
"isExplicit": false,
"titleShort": "Instant Crush"
},
{
"url": "https://www.deezer.com/track/3135563",
"album": "Discovery",
"image": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
"title": "Veridis Quo",
"albumId": 302127,
"preview": "https://cdnt-preview.dzcdn.net/api/1/1/6/4/5/0/6456b666c0b1d4537e34d71e5cbd098c.mp3?hdnea=exp=1779796842~acl=/api/1/1/6/4/5/0/6456b666c0b1d4537e34d71e5cbd098c.mp3*~data=user_id=0,a…",
"trackId": 3135563,
"playCount": 928445,
"durationMs": 345000,
"isExplicit": false,
"titleShort": "Veridis Quo"
}
],
"albumCount": 38
}Related APIs
More in music
Spotify
music/spotify
Search tracks, albums, and artists on Spotify. Returns metadata + 30s preview URLs. Full audio is DRM-protected.
32 calls5m cache
SoundCloud
music/soundcloud
Search tracks, fetch metadata, and extract full audio download URLs (progressive MP3 / HLS) for public SoundCloud tracks.
26 calls5m cache
JioSaavn
music/jiosaavn
Search and fetch songs, albums, and playlists from JioSaavn with full audio download URLs at multiple bitrates.
35 calls5m cache
Apple Music
music/apple-music
Search tracks, albums, and artists via the iTunes catalog. Returns metadata + 30s preview URLs.
10 calls5m cache
Shazam
music/shazam
Song search via the Shazam catalog, plus per-country chart top tracks. Note: audio-fingerprint recognition is not implemented.
8 calls5m cache
Genius
music/genius
Search songs and fetch full lyrics from Genius. Returns clean text with section markers preserved.
7 calls5m cache