BYTETOOLS

Deezer API

Free Deezer API with no key for public data: artists, albums, tracks, charts and 30-second previews. Rich metadata and images. Tested curl example.

No API key requiredHTTPSFree tier

Endpoint tested and returned HTTP 200 on 2026-08-19

What is the Deezer API?

The Deezer API provides free access to a catalogue of over 90 million tracks. Public data — artists, albums, tracks, charts and 30-second previews — requires no API key; only user-specific data needs OAuth.

Deezer's public endpoints are genuinely open, which is unusual for a major streaming service. Artist profiles, album track listings, charts and search all work with a plain GET request and no credentials at all.

Every track includes a 30-second preview URL and artwork at several resolutions, making it a strong choice for music discovery interfaces. Note there is no CORS header on the public endpoints, so browser calls need a server-side proxy — Deezer also publishes a JS SDK that works around this.

Quick facts

Base URL
https://api.deezer.com
Authentication
Public catalogue data needs no key. OAuth is required only for user playlists, favourites and account data.
Rate limit
Approximately 50 requests per 5 seconds per IP.
Pricing
Free for public catalogue access.
CORS
Not enabled — call it from your server
Official docs
Read the docs

How to use the Deezer API

Every request below was executed against the live API on 2026-08-19, and the response shown is the real body it returned — not an illustration.

1. Fetch an artist's profile

GET https://api.deezer.com/artist/27

curl
curl 'https://api.deezer.com/artist/27'
JavaScript (fetch)
const res = await fetch("https://api.deezer.com/artist/27");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);
Python (requests)
import requests

res = requests.get("https://api.deezer.com/artist/27", timeout=20)
res.raise_for_status()
print(res.json())
Response — HTTP 200
{
  "id": 27,
  "name": "Daft Punk",
  "link": "https://www.deezer.com/artist/27",
  "share": "https://www.deezer.com/artist/27?utm_source=deezer&utm_content=artist-27&utm_term=0_1787144827&utm_medium=web",
  "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",
  "nb_album": 12,
  "nb_fan": 5191214,
  "radio": true,
  "tracklist": "https://api.deezer.com/artist/27/top?limit=50",
  "type": "artist"
}

Parameters

ParameterTypeRequiredDescription
<resource>pathRequiredartist, album, track, playlist or chart. artist
<id>pathOptionalDeezer resource id. 27
qqueryOptionalSearch query on /search endpoints. daft punk
index / limitqueryOptionalPagination offset and page size. 25

Response fields

id / nameinteger|string
Resource identifier and name.
nb_album / nb_faninteger
Album count and fan count on artist records.
picture_xl / cover_xlstring
High-resolution images at several sizes.
previewstring
30-second MP3 preview URL on track records.
trackliststring
URL to fetch the artist's or album's tracks.

What you can build with the Deezer API

  • Build a music discovery interface with previews and artwork
  • Display charts and trending tracks by country
  • Look up artist and album metadata for a media library
  • Create playlists browsers backed by a large catalogue

Common errors and how to fix them

error object with code 800

No data — usually an invalid resource id.

Fix: Search first to resolve names to ids rather than guessing.

CORS blocked in the browser

Public endpoints send no CORS headers.

Fix: Call it from your server, or use Deezer's official JS SDK which handles this.

Quota exceeded

More than ~50 requests per 5 seconds.

Fix: Throttle and cache; catalogue data changes rarely.

Deezer API — frequently asked questions

Does the Deezer API require authentication?

Not for public catalogue data — artists, albums, tracks, charts and search all work with no key. OAuth is only needed for user-specific data such as playlists and favourites.

Can I call the Deezer API from browser JavaScript?

Not directly, because the public endpoints do not send CORS headers. Proxy the request through your server or use Deezer's official JS SDK.

Does Deezer provide full song audio?

No. Only 30-second preview clips are available through the API. Full playback requires the Deezer SDK and an authenticated premium user.

How large is the Deezer catalogue?

Over 90 million tracks, which is comparable to other major streaming services and makes it a solid source for music metadata.

Tools that pair with this API

JSON Formatter

Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.

URL Encoder

Percent-encode text for URLs instantly. Switch between encodeURIComponent and encodeURI modes, see live output and copy the result. Free URL encoder.

Deezer is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 2026-08-19; always check the official documentation before relying on this API in production, as terms and limits can change.