# Deezer API
> Real-time Deezer music data as an API — tracks, albums, artists, playlists, charts and genres, returned as clean JSON. Search the catalogue for tracks, albums, artists and playlists; fetch any track, album (with its track list), artist or playlist by id; get an artist's top tracks and full discography; pull the global charts (top tracks, albums, artists and playlists) and the list of genres. Live data with titles, durations, ranks, fan counts, cover and picture art, 30-second preview URLs, release dates and explicit flags. Ideal for music apps and players, recommendation and discovery tools, metadata enrichment, dashboards and research. 12 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/deezer-api/..."
```

## Pricing
- **Free** (Free) — 1,000 calls/Mo, 3 req/s
- **Starter** ($13/Mo) — 30,000 calls/Mo, 10 req/s
- **Pro** ($45/Mo) — 180,000 calls/Mo, 25 req/s
- **Mega** ($149/Mo) — 900,000 calls/Mo, 60 req/s

## Endpoints

### Search

#### `GET /v1/search` — Search tracks

**Parameters:**
- `query` (query, required, string) — Search query Example: `daft punk`
- `limit` (query, optional, string) — Max results (1–100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deezer-api/v1/search?query=daft+punk&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "query": "daft punk",
        "total": 165,
        "tracks": [
            {
                "id": 66609426,
                "link": "https://www.deezer.com/track/66609426",
                "rank": 954234,
                "album": {
                    "id": 6516139,
                    "cover": "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)"
                },
                "title": "Get Lucky (Radio Edit - feat. Pharrell Williams and Nile Rodgers)",
                "artist": {
                    "id": 27,
                    "link": "https://www.deezer.com/artist/27",
                    "name": "Daft Punk",
                    "picture": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg"
                },
                "preview": "https://cdnt-preview.dzcdn.net/api/1/1/1/b/f/0/1bf80a82992903ff685ba1b7275223f8.mp3?hdnea=exp=1780851823~acl=/api/1/1/1/b/f/0/1bf80a82992903ff685ba1b7275223f8.mp3*~data=user_id=0,application_id=42~hmac=237d6cc44ea2559c9dc1ba35d879821c43e08874b2744c00d2fbf2a3b97a015b",
                "explicit": false,
                "duration_s": 248,
                "title_short": "Get Lucky"
            },
            {
                "id": 136889400,
                "link": "https://www.deezer.com/tr
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search/albums` — Search albums

**Parameters:**
- `query` (query, required, string) — Search query Example: `random access memories`
- `limit` (query, optional, string) — Max results Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deezer-api/v1/search/albums?query=random+access+memories&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "query": "random access memories",
        "total": 20,
        "albums": [
            {
                "id": 6575789,
                "link": "https://www.deezer.com/album/6575789",
                "cover": "https://cdn-images.dzcdn.net/images/cover/311bba0fc112d15f72c8b5a65f0456c1/1000x1000-000000-80-0-0.jpg",
                "title": "Random Access Memories",
                "artist": {
                    "id": 27,
                    "link": "https://www.deezer.com/artist/27",
                    "name": "Daft Punk",
                    "picture": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg"
                },
                "genres": [],
                "explicit": false,
                "genre_id": 113,
                "nb_tracks": 13,
                "record_type": "album"
            },
            {
                "id": 438167857,
                "link": "https://www.deezer.com/album/438167857",
                "cover": "https://cdn-images.dzcdn.net/images/cover/ad250e6b44b43490a294d90d6104e124/1000x1000-000000-80-0-0.jpg",
                "title": "Random Access Memories (10th Anniversary Edition)",
                "artist": {
                    "id": 27,
                    "link": "https://www.deezer.com/artist/27",
                    "name": "Daft Punk",
                    "picture": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826fe
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search/artists` — Search artists

**Parameters:**
- `query` (query, required, string) — Search query Example: `the weeknd`
- `limit` (query, optional, string) — Max results Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deezer-api/v1/search/artists?query=the+weeknd&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "query": "the weeknd",
        "total": 73,
        "artists": [
            {
                "id": 4050205,
                "link": "https://www.deezer.com/artist/4050205",
                "name": "The Weeknd",
                "radio": true,
                "nb_fans": 14491968,
                "picture": "https://cdn-images.dzcdn.net/images/artist/581693b4724a7fcfa754455101e13a44/1000x1000-000000-80-0-0.jpg",
                "nb_albums": 86
            },
            {
                "id": 315582831,
                "link": "https://www.deezer.com/artist/315582831",
                "name": "The Weeknd",
                "radio": true,
                "nb_fans": 18,
                "picture": "https://cdn-images.dzcdn.net/images/artist/d41d8cd98f00b204e9800998ecf8427e/1000x1000-000000-80-0-0.jpg",
                "nb_albums": 0
            },
            {
                "id": 188197757,
                "link": "https://www.deezer.com/artist/188197757",
                "name": "The Retro Weeknd",
                "radio": true,
                "nb_fans": 63,
                "picture": "https://cdn-images.dzcdn.net/images/artist/d8cfeb4333d11f466dab301f2e09bd6b/1000x1000-000000-80-0-0.jpg",
                "nb_albums": 5
            },
            {
                "id": 341712231,
                "link": "https://www.deezer.com/artist/341712231",
                "name": "The Masked Weeknd",
                "radio": true,
         
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search/playlists` — Search playlists

**Parameters:**
- `query` (query, required, string) — Search query Example: `workout`
- `limit` (query, optional, string) — Max results Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deezer-api/v1/search/playlists?query=workout&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "query": "workout",
        "total": 183,
        "playlists": [
            {
                "id": 1936903262,
                "link": "https://www.deezer.com/playlist/1936903262",
                "title": "EDM Workout",
                "public": true,
                "picture": "https://cdn-images.dzcdn.net/images/playlist/49be8898206717148b6d04cc2a067ca9/1000x1000-000000-80-0-0.jpg",
                "nb_tracks": 50,
                "creation_date": "2016-06-17 12:36:36"
            },
            {
                "id": 12134756071,
                "link": "https://www.deezer.com/playlist/12134756071",
                "title": "Hits Remixed",
                "public": true,
                "picture": "https://cdn-images.dzcdn.net/images/playlist/b2e636477df7831f05d235e3a2739a2d/1000x1000-000000-80-0-0.jpg",
                "nb_tracks": 50,
                "creation_date": "2023-12-15 18:02:01"
            },
            {
                "id": 2532117644,
                "link": "https://www.deezer.com/playlist/2532117644",
                "title": "Pop Workout",
                "public": true,
                "picture": "https://cdn-images.dzcdn.net/images/playlist/5f55d4c9033ff8e3b4bf5aa9f40c99d1/1000x1000-000000-80-0-0.jpg",
                "nb_tracks": 80,
                "creation_date": "2016-12-07 18:03:09"
            },
            {
                "id": 12593959543,
                "link": "https://www.deezer.com/pla
…(truncated, see openapi.json for full schema)
```

### Catalogue

#### `GET /v1/album` — Album and tracks by id

**Parameters:**
- `id` (query, required, string) — Deezer album id Example: `6516139`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deezer-api/v1/album?id=6516139"
```

**Response:**
```json
{
    "data": {
        "album": {
            "id": 6516139,
            "fans": 160861,
            "link": "https://www.deezer.com/album/6516139",
            "cover": "https://cdn-images.dzcdn.net/images/cover/bc49adb87758e0c8c4e508a9c5cce85d/1000x1000-000000-80-0-0.jpg",
            "label": "Columbia",
            "title": "Get Lucky (Radio Edit - feat. Pharrell Williams and Nile Rodgers)",
            "artist": {
                "id": 27,
                "name": "Daft Punk",
                "picture": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg"
            },
            "genres": [
                {
                    "id": 106,
                    "name": "Electro"
                },
                {
                    "id": 110,
                    "name": "Electro Pop/Electro Rock"
                },
                {
                    "id": 111,
                    "name": "Techno/House"
                },
                {
                    "id": 113,
                    "name": "Dance"
                },
                {
                    "id": 132,
                    "name": "Pop"
                },
                {
                    "id": 134,
                    "name": "International Pop"
                },
                {
                    "id": 152,
                    "name": "Rock"
                },
                {
                    "id": 165,
                    "name":
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/artist` — Artist by id

**Parameters:**
- `id` (query, required, string) — Deezer artist id Example: `27`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deezer-api/v1/artist?id=27"
```

**Response:**
```json
{
    "data": {
        "artist": {
            "id": 27,
            "link": "https://www.deezer.com/artist/27",
            "name": "Daft Punk",
            "radio": true,
            "nb_fans": 5159342,
            "picture": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg",
            "nb_albums": 38
        }
    },
    "meta": {
        "timestamp": "2026-06-07T16:48:47.110Z",
        "request_id": "53424228-2ac3-407c-865c-692ea28d0fa6"
    },
    "status": "ok",
    "message": "Artist retrieved successfully",
    "success": true
}
```

#### `GET /v1/artist/albums` — Artist albums

**Parameters:**
- `id` (query, required, string) — Deezer artist id Example: `27`
- `limit` (query, optional, string) — Max albums Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deezer-api/v1/artist/albums?id=27&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "albums": [
            {
                "id": 494309801,
                "fans": 14160,
                "link": "https://www.deezer.com/album/494309801",
                "cover": "https://cdn-images.dzcdn.net/images/cover/bb8b5f188ae380ac3a7c876b70556357/1000x1000-000000-80-0-0.jpg",
                "title": "Random Access Memories (Drumless Edition)",
                "genres": [],
                "explicit": false,
                "genre_id": 106,
                "record_type": "album",
                "release_date": "2023-11-17"
            },
            {
                "id": 294609352,
                "fans": 17117,
                "link": "https://www.deezer.com/album/294609352",
                "cover": "https://cdn-images.dzcdn.net/images/cover/117dcf85bdf0851347403796521d1e9d/1000x1000-000000-80-0-0.jpg",
                "title": "Homework (25th Anniversary Edition)",
                "genres": [],
                "explicit": false,
                "genre_id": 113,
                "record_type": "album",
                "release_date": "1997-01-20"
            },
            {
                "id": 6575789,
                "fans": 876221,
                "link": "https://www.deezer.com/album/6575789",
                "cover": "https://cdn-images.dzcdn.net/images/cover/311bba0fc112d15f72c8b5a65f0456c1/1000x1000-000000-80-0-0.jpg",
                "title": "Random Access Memories",
                "genres": [],
          
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/artist/top` — Artist top tracks

**Parameters:**
- `id` (query, required, string) — Deezer artist id Example: `27`
- `limit` (query, optional, string) — Max tracks Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deezer-api/v1/artist/top?id=27&limit=10"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "tracks": [
            {
                "id": 66609426,
                "link": "https://www.deezer.com/track/66609426",
                "rank": 954234,
                "album": {
                    "id": 6516139,
                    "cover": "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)"
                },
                "title": "Get Lucky (Radio Edit - feat. Pharrell Williams and Nile Rodgers)",
                "artist": {
                    "id": 27,
                    "name": "Daft Punk"
                },
                "preview": "https://cdnt-preview.dzcdn.net/api/1/1/1/b/f/0/1bf80a82992903ff685ba1b7275223f8.mp3?hdnea=exp=1780851828~acl=/api/1/1/1/b/f/0/1bf80a82992903ff685ba1b7275223f8.mp3*~data=user_id=0,application_id=42~hmac=0764e6afe805f57fff539ee8ac0a1491bb5d6fca43acf669df15e832b84d9653",
                "explicit": false,
                "duration_s": 248,
                "title_short": "Get Lucky"
            },
            {
                "id": 3135553,
                "link": "https://www.deezer.com/track/3135553",
                "rank": 895695,
                "album": {
                    "id": 302127,
                    "cover": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
              
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/playlist` — Playlist and tracks by id

**Parameters:**
- `id` (query, required, string) — Deezer playlist id Example: `908622995`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deezer-api/v1/playlist?id=908622995"
```

**Response:**
```json
{
    "data": {
        "tracks": [
            {
                "id": 116348632,
                "link": "https://www.deezer.com/track/116348632",
                "rank": 839332,
                "album": {
                    "id": 12047956,
                    "cover": "https://cdn-images.dzcdn.net/images/cover/c65b3bd84e81056e060be144381c06c8/1000x1000-000000-80-0-0.jpg",
                    "title": "1 (Remastered)"
                },
                "title": "Hey Jude (Remastered 2015)",
                "artist": {
                    "id": 1,
                    "link": "https://www.deezer.com/artist/1",
                    "name": "The Beatles"
                },
                "preview": "https://cdnt-preview.dzcdn.net/api/1/1/b/e/3/0/be3c33e5b05a25dc63b8951748615d74.mp3?hdnea=exp=1780851828~acl=/api/1/1/b/e/3/0/be3c33e5b05a25dc63b8951748615d74.mp3*~data=user_id=0,application_id=42~hmac=fc319762692b865197433db25de5baca7697e5cd63b92a404b1b2925cd1a4689",
                "explicit": false,
                "duration_s": 429,
                "title_short": "Hey Jude"
            },
            {
                "id": 92551068,
                "link": "https://www.deezer.com/track/92551068",
                "rank": 528418,
                "album": {
                    "id": 9392704,
                    "cover": "https://cdn-images.dzcdn.net/images/cover/9e92eafc4763ff46daa2e17b6df33717/1000x1000-000000-80-0-0.jpg",
                    "title": "Georgia on My Mind (Remast
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/track` — Track by id

**Parameters:**
- `id` (query, required, string) — Deezer track id Example: `66609426`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deezer-api/v1/track?id=66609426"
```

**Response:**
```json
{
    "data": {
        "track": {
            "id": 66609426,
            "link": "https://www.deezer.com/track/66609426",
            "rank": 954234,
            "album": {
                "id": 6516139,
                "cover": "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)"
            },
            "title": "Get Lucky (Radio Edit - feat. Pharrell Williams and Nile Rodgers)",
            "artist": {
                "id": 27,
                "link": "https://www.deezer.com/artist/27",
                "name": "Daft Punk",
                "picture": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg"
            },
            "preview": "https://cdnt-preview.dzcdn.net/api/1/1/1/b/f/0/1bf80a82992903ff685ba1b7275223f8.mp3?hdnea=exp=1780851829~acl=/api/1/1/1/b/f/0/1bf80a82992903ff685ba1b7275223f8.mp3*~data=user_id=0,application_id=42~hmac=c93183ece1d30734e267d6378ad4c172ba18afc85981493ca8b06feca2fe9919",
            "explicit": false,
            "duration_s": 248,
            "title_short": "Get Lucky",
            "release_date": "2013-04-19",
            "track_position": 1
        }
    },
    "meta": {
        "timestamp": "2026-06-07T16:48:49.600Z",
        "request_id": "d7d3a852-dc55-46f0-aabd-0f57797bf7f9"
    },
    "status": "ok",
    "message": "Track retrieved s
…(truncated, see openapi.json for full schema)
```

### Charts

#### `GET /v1/chart` — Top charts

**Parameters:**
- `genre_id` (query, optional, string) — Genre id (default 0 = all) Example: `0`
- `limit` (query, optional, string) — Max per section Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deezer-api/v1/chart?genre_id=0&limit=10"
```

**Response:**
```json
{
    "data": {
        "albums": [
            {
                "id": 945481241,
                "link": "https://www.deezer.com/album/945481241",
                "cover": "https://cdn-images.dzcdn.net/images/cover/18d2169cc814aef101da81172ca7b9b4/1000x1000-000000-80-0-0.jpg",
                "title": "Folge 239: Das Geheimnis der sieben Palmen",
                "artist": {
                    "id": 71513,
                    "link": "https://www.deezer.com/artist/71513",
                    "name": "Die drei ???",
                    "picture": "https://cdn-images.dzcdn.net/images/artist/ac1cd9a5c56dd71464fceca49dbf9853/1000x1000-000000-80-0-0.jpg"
                },
                "genres": [],
                "explicit": false,
                "record_type": "album"
            },
            {
                "id": 944183651,
                "link": "https://www.deezer.com/album/944183651",
                "cover": "https://cdn-images.dzcdn.net/images/cover/db8c6f889c49aaf75c30cef4dbd1e806/1000x1000-000000-80-0-0.jpg",
                "title": "Folge 164: Hexerei im Cluburlaub",
                "artist": {
                    "id": 64579,
                    "link": "https://www.deezer.com/artist/64579",
                    "name": "Bibi Blocksberg",
                    "picture": "https://cdn-images.dzcdn.net/images/artist/49612d7767a0a5f4ec2cc7ff45a16d40/1000x1000-000000-80-0-0.jpg"
                },
                "genres": [],
                "explicit": false,
 
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/genres` — Music genres

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deezer-api/v1/genres"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "genres": [
            {
                "id": 0,
                "name": "Alle",
                "picture": "https://cdn-images.dzcdn.net/images/misc//1000x1000-000000-80-0-0.jpg"
            },
            {
                "id": 132,
                "name": "Pop",
                "picture": "https://cdn-images.dzcdn.net/images/misc/db7a604d9e7634a67d45cfc86b48370a/1000x1000-000000-80-0-0.jpg"
            },
            {
                "id": 457,
                "name": "Hörbücher",
                "picture": "https://cdn-images.dzcdn.net/images/misc/8b0c8494e267e0e02bbb09b8ad7aac6f/1000x1000-000000-80-0-0.jpg"
            },
            {
                "id": 116,
                "name": "Rap/Hip Hop",
                "picture": "https://cdn-images.dzcdn.net/images/misc/5c27115d3b797954afff59199dad98d1/1000x1000-000000-80-0-0.jpg"
            },
            {
                "id": 152,
                "name": "Rock",
                "picture": "https://cdn-images.dzcdn.net/images/misc/b36ca681666d617edd0dcb5ab389a6ac/1000x1000-000000-80-0-0.jpg"
            },
            {
                "id": 113,
                "name": "Dance",
                "picture": "https://cdn-images.dzcdn.net/images/misc/bd5fdfa1a23e02e2697818e09e008e69/1000x1000-000000-80-0-0.jpg"
            },
            {
                "id": 165,
                "name": "R&B",
                "picture": "https://cdn-images.dzcdn.net/images/misc/68a43aec
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deezer-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "service": "deezer-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/album": "Album and its tracks by id.",
            "GET /v1/chart": "Top tracks, albums, artists, playlists.",
            "GET /v1/track": "Track by id.",
            "GET /v1/artist": "Artist by id.",
            "GET /v1/genres": "Music genres.",
            "GET /v1/search": "Search tracks.",
            "GET /v1/playlist": "Playlist and its tracks by id.",
            "GET /v1/artist/top": "An artist's top tracks.",
            "GET /v1/artist/albums": "An artist's albums.",
            "GET /v1/search/albums": "Search albums.",
            "GET /v1/search/artists": "Search artists.",
            "GET /v1/search/playlists": "Search playlists."
        },
        "description": "Deezer data: tracks, albums, artists, playlists, search, charts and genres — real live data."
    },
    "meta": {
        "timestamp": "2026-06-07T16:48:50.980Z",
        "request_id": "8552ab1e-f51e-4045-9983-34f0d3d7586d"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/deezer-api
OpenAPI spec: https://www.oanor.com/api/deezer-api/openapi.json