# Deezer

> Search and read Deezer's music catalogue: find tracks, albums, artists, playlists and podcasts, read an album's track listing or an artist's top songs and similar acts, follow the daily charts by genre, and pull a podcast's episodes. Uses Deezer's free public API, so no account or API key is needed.

App · Music & Podcasts · 20 actions. Web page: https://docs.lodol.com/docs/integrations/deezer

## Actions

### Get a playlist

Read one public playlist: who made it, what it is for, how long it runs and how many people follow it. Use 'Get playlist tracks' for its contents.

**Inputs**

- Playlist (`playlist_id`, text, required): The Deezer id of the playlist, for example '908622995'. It is the number at the end of the playlist's deezer.com link, and it is what this integration's other actions return.

**Outputs**

- `collaborative` (true/false): Whether other people may add to it
- `created_at` (text): When it was created, as an ISO 8601 timestamp
- `creator` (object): Who put the playlist together
- `description` (text): What its creator says it is for
- `duration` (text): How long it runs in total, written as h:mm:ss
- `duration_seconds` (number): How long it runs in total, in seconds
- `fans` (number): How many people follow it
- `id` (text): The playlist's Deezer id
- `link` (text): Link to the playlist on Deezer
- `nb_tracks` (number): How many tracks it holds
- `picture_url` (text): Link to the playlist artwork
- `public` (true/false): Whether anyone can see it
- `title` (text): The playlist title
- `updated_at` (text): When it last changed, as an ISO 8601 timestamp

**Example output**

```json
{
  "collaborative": false,
  "created_at": "2014-06-27T04:09:31",
  "creator": {
    "id": "1687950",
    "link": "",
    "name": "Alexandre - Pop & Hits Editor"
  },
  "description": "Les meilleurs hits des annees 60.",
  "duration": "2:31:39",
  "duration_seconds": 9099,
  "fans": 22559,
  "id": "908622995",
  "link": "https://www.deezer.com/playlist/908622995",
  "nb_tracks": 50,
  "picture_url": "https://cdn-images.dzcdn.net/images/playlist/4fd375a41c7779ed7deab64fb1194099/1000x1000-000000-80-0-0.jpg",
  "public": true,
  "title": "En mode 60",
  "updated_at": "2026-07-31T22:15:23"
}
```

### Get a podcast episode

Read one podcast episode in full, including the show notes that the episode listing leaves out.

**Inputs**

- Episode (`episode_id`, text, required): The Deezer id of the episode, for example '923878872'. It is the number at the end of the episode's deezer.com link, and it is what this integration's other actions return.

**Outputs**

- `available` (true/false): Whether Deezer can play it in your country
- `description` (text): The episode's show notes
- `duration` (text): How long it runs, written as m:ss or h:mm:ss
- `duration_seconds` (number): How long it runs, in seconds
- `id` (text): The episode's Deezer id
- `link` (text): Link to the episode on Deezer
- `picture_url` (text): Link to the episode artwork
- `podcast` (object): The show the episode belongs to
- `released_at` (text): When it was published, as an ISO 8601 timestamp
- `title` (text): The episode title

**Example output**

```json
{
  "available": true,
  "description": "Alyssa Romine-Olson was found dead in her home in 2019, and the case is still open.",
  "duration": "55:34",
  "duration_seconds": 3334,
  "id": "923878872",
  "link": "https://www.deezer.com/episode/923878872",
  "picture_url": "https://cdn-images.dzcdn.net/images/talk/6204798169a5a315097b3712cd2b0203/180x180-000000-80-0-0.jpg",
  "podcast": {
    "id": "1520212",
    "link": "https://www.deezer.com/show/1520212",
    "title": "Morbid"
  },
  "released_at": "2026-08-24T07:00:00",
  "title": "MYSTERIOUS DEATH OF: Alyssa Romine-Olson"
}
```

### Get a track

Read one track in full: its artist and album, how long it runs, its ISRC and release date, and a link to a 30-second preview.

**Inputs**

- Track (`track_id`, text, required): The Deezer id of the track, for example '3135556'. It is the number at the end of the track's deezer.com link, and it is what this integration's other actions return.

**Outputs**

- `album` (object): The album the track appears on
- `artist` (object): The artist, as a reference you can pass to the artist actions
- `bpm` (number): Its tempo in beats per minute, to two decimal places, when Deezer has measured it
- `contributors` (list): Every credited artist, the main one first
- `disk_number` (number): Which disc of the album it sits on
- `duration` (text): How long the track runs, written as m:ss
- `duration_seconds` (number): How long the track runs, in seconds
- `explicit` (true/false): Whether the lyrics are flagged explicit
- `id` (text): The track's Deezer id
- `isrc` (text): The recording's ISRC, the industry code that identifies it across services
- `link` (text): Link to the track on Deezer
- `preview_url` (text): Link to a 30-second MP3 preview
- `rank` (number): Deezer's popularity score for the track, 0 to 1,000,000
- `release_date` (text): When it was released, as YYYY-MM-DD
- `title` (text): The track title
- `track_position` (number): Its position on its album, when the listing says

**Example output**

```json
{
  "album": {
    "cover_url": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
    "id": "302127",
    "title": "Discovery"
  },
  "artist": {
    "id": "27",
    "link": "https://www.deezer.com/artist/27",
    "name": "Daft Punk"
  },
  "bpm": 123.4,
  "contributors": [
    {
      "id": "27",
      "link": "https://www.deezer.com/artist/27",
      "name": "Daft Punk"
    }
  ],
  "disk_number": 1,
  "duration": "3:46",
  "duration_seconds": 226,
  "explicit": false,
  "id": "3135556",
  "isrc": "GBDUW0000059",
  "link": "https://www.deezer.com/track/3135556",
  "preview_url": "https://cdnt-preview.dzcdn.net/api/1/1/6/a/2/0/6a2c0a56.mp3",
  "rank": 810329,
  "release_date": "2001-03-12",
  "title": "Harder, Better, Faster, Stronger",
  "track_position": 4
}
```

### Get album tracks

List an album's track listing, in running order.

**Inputs**

- Album (`album_id`, text, required): The Deezer id of the album, for example '302127'. It is the number at the end of the album's deezer.com link, and it is what this integration's other actions return.
- How many results (`limit`, number): How many results to return (1-100). Deezer serves at most 100 per request. From 1 to 100. Default: `50`.
- Skip this many (`offset`, number): How many results to skip before returning any. Use it to read the next page: skip 25 to read results 26 onwards. From 0 to 10000. Default: `0`.

**Outputs**

- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `total` (number): How many records match in total, across every page
- `tracks` (list): The album's tracks, in running order

**Example output**

```json
{
  "has_more": false,
  "total": 14,
  "tracks": [
    {
      "album": {
        "cover_url": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
        "id": "302127",
        "title": "Discovery"
      },
      "artist": {
        "id": "27",
        "link": "https://www.deezer.com/artist/27",
        "name": "Daft Punk"
      },
      "duration": "3:46",
      "duration_seconds": 226,
      "explicit": false,
      "id": "3135556",
      "link": "https://www.deezer.com/track/3135556",
      "preview_url": "https://cdnt-preview.dzcdn.net/api/1/1/6/a/2/0/6a2c0a56.mp3",
      "rank": 810329,
      "title": "Harder, Better, Faster, Stronger",
      "track_position": 4
    }
  ]
}
```

### Get an album

Read one album in full: its artist, label, genres, release date, running time and how many people have favourited it. Use 'Get album tracks' for the track listing.

**Inputs**

- Album (`album_id`, text, required): The Deezer id of the album, for example '302127'. It is the number at the end of the album's deezer.com link, and it is what this integration's other actions return.

**Outputs**

- `artist` (object): The artist, as a reference you can pass to the artist actions
- `available` (true/false): Whether Deezer can play it in your country
- `contributors` (list): Every credited artist, the main one first
- `cover_url` (text): Link to the album artwork
- `duration` (text): How long the album runs, written as h:mm:ss
- `duration_seconds` (number): How long the album runs, in seconds
- `explicit` (true/false): Whether any of its lyrics are flagged explicit
- `fans` (number): How many people have favourited it
- `genres` (list): The genres Deezer files it under
- `id` (text): The album's Deezer id
- `label` (text): The record label that released it
- `link` (text): Link to the album on Deezer
- `nb_tracks` (number): How many tracks it holds
- `record_type` (text): What kind of release: album, single, ep or compilation
- `release_date` (text): When it was released, as YYYY-MM-DD
- `title` (text): The album title
- `upc` (text): The release's UPC barcode

**Example output**

```json
{
  "artist": {
    "id": "27",
    "link": "https://www.deezer.com/artist/27",
    "name": "Daft Punk"
  },
  "available": true,
  "contributors": [
    {
      "id": "27",
      "link": "https://www.deezer.com/artist/27",
      "name": "Daft Punk"
    }
  ],
  "cover_url": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
  "duration": "1:01:02",
  "duration_seconds": 3662,
  "explicit": false,
  "fans": 339905,
  "genres": [
    "Electro"
  ],
  "id": "302127",
  "label": "Daft Life Ltd./ADA France",
  "link": "https://www.deezer.com/album/302127",
  "nb_tracks": 14,
  "record_type": "album",
  "release_date": "2001-03-07",
  "title": "Discovery",
  "upc": "724384960650"
}
```

### Get an artist

Read one artist: their picture, how many releases they have and how many listeners follow them.

**Inputs**

- Artist (`artist_id`, text, required): The Deezer id of the artist, for example '27'. It is the number at the end of the artist's deezer.com link, and it is what this integration's other actions return.

**Outputs**

- `has_radio` (true/false): Whether Deezer offers a radio station built around this artist
- `id` (text): The artist's Deezer id
- `link` (text): Link to the artist on Deezer
- `name` (text): The artist's name
- `nb_album` (number): How many releases they have
- `nb_fan` (number): How many people follow them
- `picture_url` (text): Link to the artist's picture

**Example output**

```json
{
  "has_radio": true,
  "id": "27",
  "link": "https://www.deezer.com/artist/27",
  "name": "Daft Punk",
  "nb_album": 38,
  "nb_fan": 5195690,
  "picture_url": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg"
}
```

### Get an artist's albums

List an artist's releases, newest first, each marked as an album, single, EP or compilation.

**Inputs**

- Artist (`artist_id`, text, required): The Deezer id of the artist, for example '27'. It is the number at the end of the artist's deezer.com link, and it is what this integration's other actions return.
- How many results (`limit`, number): How many results to return (1-100). Deezer serves at most 100 per request. From 1 to 100. Default: `25`.
- Skip this many (`offset`, number): How many results to skip before returning any. Use it to read the next page: skip 25 to read results 26 onwards. From 0 to 10000. Default: `0`.

**Outputs**

- `albums` (list): The artist's releases, newest first
- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `total` (number): How many records match in total, across every page

**Example output**

```json
{
  "albums": [
    {
      "artist": {
        "id": "27",
        "link": "https://www.deezer.com/artist/27",
        "name": "Daft Punk"
      },
      "cover_url": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
      "explicit": false,
      "fans": 339905,
      "id": "302127",
      "link": "https://www.deezer.com/album/302127",
      "nb_tracks": 14,
      "record_type": "album",
      "release_date": "2001-03-07",
      "title": "Discovery"
    }
  ],
  "has_more": true,
  "total": 38
}
```

### Get an artist's radio mix

Build a mix of tracks around one artist: their own songs blended with ones Deezer thinks sit alongside them. Answers 'more like this' in tracks rather than in artist names.

**Inputs**

- Artist (`artist_id`, text, required): The Deezer id of the artist, for example '27'. It is the number at the end of the artist's deezer.com link, and it is what this integration's other actions return.
- How many results (`limit`, number): How many results to return (1-100). Deezer serves at most 100 per request. From 1 to 100. Default: `25`.

**Outputs**

- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `total` (number): How many records match in total, across every page
- `tracks` (list): The mix Deezer builds around the artist, in play order

**Example output**

```json
{
  "has_more": false,
  "total": 25,
  "tracks": [
    {
      "album": {
        "cover_url": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
        "id": "302127",
        "title": "Discovery"
      },
      "artist": {
        "id": "27",
        "link": "https://www.deezer.com/artist/27",
        "name": "Daft Punk"
      },
      "duration": "3:46",
      "duration_seconds": 226,
      "explicit": false,
      "id": "3135556",
      "link": "https://www.deezer.com/track/3135556",
      "preview_url": "https://cdnt-preview.dzcdn.net/api/1/1/6/a/2/0/6a2c0a56.mp3",
      "rank": 810329,
      "title": "Harder, Better, Faster, Stronger",
      "track_position": 4
    }
  ]
}
```

### Get an artist's top tracks

List an artist's most popular tracks on Deezer, most popular first.

**Inputs**

- Artist (`artist_id`, text, required): The Deezer id of the artist, for example '27'. It is the number at the end of the artist's deezer.com link, and it is what this integration's other actions return.
- How many results (`limit`, number): How many results to return (1-100). Deezer serves at most 100 per request. From 1 to 100. Default: `25`.
- Skip this many (`offset`, number): How many results to skip before returning any. Use it to read the next page: skip 25 to read results 26 onwards. From 0 to 10000. Default: `0`.

**Outputs**

- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `total` (number): How many records match in total, across every page
- `tracks` (list): The artist's tracks, most popular first

**Example output**

```json
{
  "has_more": true,
  "total": 100,
  "tracks": [
    {
      "album": {
        "cover_url": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
        "id": "302127",
        "title": "Discovery"
      },
      "artist": {
        "id": "27",
        "link": "https://www.deezer.com/artist/27",
        "name": "Daft Punk"
      },
      "duration": "3:46",
      "duration_seconds": 226,
      "explicit": false,
      "id": "3135556",
      "link": "https://www.deezer.com/track/3135556",
      "preview_url": "https://cdnt-preview.dzcdn.net/api/1/1/6/a/2/0/6a2c0a56.mp3",
      "rank": 810329,
      "title": "Harder, Better, Faster, Stronger",
      "track_position": 4
    }
  ]
}
```

### Get playlist tracks

List a public playlist's tracks, in playlist order.

**Inputs**

- Playlist (`playlist_id`, text, required): The Deezer id of the playlist, for example '908622995'. It is the number at the end of the playlist's deezer.com link, and it is what this integration's other actions return.
- How many results (`limit`, number): How many results to return (1-100). Deezer serves at most 100 per request. From 1 to 100. Default: `50`.
- Skip this many (`offset`, number): How many results to skip before returning any. Use it to read the next page: skip 25 to read results 26 onwards. From 0 to 10000. Default: `0`.

**Outputs**

- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `total` (number): How many records match in total, across every page
- `tracks` (list): The playlist's tracks, in playlist order

**Example output**

```json
{
  "has_more": true,
  "total": 50,
  "tracks": [
    {
      "album": {
        "cover_url": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
        "id": "302127",
        "title": "Discovery"
      },
      "artist": {
        "id": "27",
        "link": "https://www.deezer.com/artist/27",
        "name": "Daft Punk"
      },
      "duration": "3:46",
      "duration_seconds": 226,
      "explicit": false,
      "id": "3135556",
      "link": "https://www.deezer.com/track/3135556",
      "preview_url": "https://cdnt-preview.dzcdn.net/api/1/1/6/a/2/0/6a2c0a56.mp3",
      "rank": 810329,
      "title": "Harder, Better, Faster, Stronger",
      "track_position": 4
    }
  ]
}
```

### Get podcast episodes

List a podcast show's episodes, newest first, with each one's publication date and running time.

**Inputs**

- Podcast (`podcast_id`, text, required): The Deezer id of the podcast show, for example '1520212'. It is the number at the end of the podcast show's deezer.com link, and it is what this integration's other actions return.
- How many results (`limit`, number): How many results to return (1-100). Deezer serves at most 100 per request. From 1 to 100. Default: `25`.
- Skip this many (`offset`, number): How many results to skip before returning any. Use it to read the next page: skip 25 to read results 26 onwards. From 0 to 10000. Default: `0`.

**Outputs**

- `episodes` (list): The show's episodes, newest first
- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `total` (number): How many records match in total, across every page

**Example output**

```json
{
  "episodes": [
    {
      "duration": "55:34",
      "duration_seconds": 3334,
      "id": "923878872",
      "link": "https://www.deezer.com/episode/923878872",
      "picture_url": "https://cdn-images.dzcdn.net/images/talk/6204798169a5a315097b3712cd2b0203/180x180-000000-80-0-0.jpg",
      "released_at": "2026-08-24T07:00:00",
      "title": "MYSTERIOUS DEATH OF: Alyssa Romine-Olson"
    }
  ],
  "has_more": true,
  "total": 525
}
```

### Get related artists

List the artists Deezer considers similar to this one, for building a recommendation out of one seed artist.

**Inputs**

- Artist (`artist_id`, text, required): The Deezer id of the artist, for example '27'. It is the number at the end of the artist's deezer.com link, and it is what this integration's other actions return.
- How many results (`limit`, number): How many results to return (1-100). Deezer serves at most 100 per request. From 1 to 100. Default: `25`.
- Skip this many (`offset`, number): How many results to skip before returning any. Use it to read the next page: skip 25 to read results 26 onwards. From 0 to 10000. Default: `0`.

**Outputs**

- `artists` (list): Artists Deezer considers similar
- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `total` (number): How many records match in total, across every page

**Example output**

```json
{
  "artists": [
    {
      "id": "27",
      "link": "https://www.deezer.com/artist/27",
      "name": "Daft Punk",
      "nb_album": 38,
      "nb_fan": 5195690,
      "picture_url": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg"
    }
  ],
  "has_more": false,
  "total": 20
}
```

### Get the charts

Read what is charting on Deezer right now: the top tracks, albums, artists, playlists and podcasts, for one genre or across all music.

**Inputs**

- Genre (`genre_id`, text): Which genre to chart. Leave it on 'All' for the overall charts. Default: `0`.
- Which charts (`lists`, list): Which of the charts to return. Choose none to get all five. One or more of: `tracks` (Top tracks), `albums` (Top albums), `artists` (Top artists), `playlists` (Top playlists), `podcasts` (Top podcasts).
- How many per chart (`limit`, number): How many entries to return in each chart (1-100). From 1 to 100. Default: `10`.

**Outputs**

- `albums` (list): The top albums, highest charting first
- `artists` (list): The top artists, highest charting first
- `genre_id` (text): The genre these charts cover; 0 is all music
- `playlists` (list): The top playlists, highest charting first
- `podcasts` (list): The top podcasts, highest charting first
- `tracks` (list): The top tracks, highest charting first

**Example output**

```json
{
  "albums": [
    {
      "artist": {
        "id": "27",
        "link": "https://www.deezer.com/artist/27",
        "name": "Daft Punk"
      },
      "cover_url": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
      "explicit": false,
      "fans": 339905,
      "id": "302127",
      "link": "https://www.deezer.com/album/302127",
      "nb_tracks": 14,
      "record_type": "album",
      "release_date": "2001-03-07",
      "title": "Discovery"
    }
  ],
  "artists": [
    {
      "id": "27",
      "link": "https://www.deezer.com/artist/27",
      "name": "Daft Punk",
      "nb_album": 38,
      "nb_fan": 5195690,
      "picture_url": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg"
    }
  ],
  "genre_id": "0",
  "playlists": [
    {
      "creator": {
        "id": "1687950",
        "link": "",
        "name": "Alexandre - Pop & Hits Editor"
      },
      "duration": "2:31:39",
      "duration_seconds": 9099,
      "fans": 22559,
      "id": "908622995",
      "link": "https://www.deezer.com/playlist/908622995",
      "nb_tracks": 50,
      "picture_url": "https://cdn-images.dzcdn.net/images/playlist/4fd375a41c7779ed7deab64fb1194099/1000x1000-000000-80-0-0.jpg",
      "public": true,
      "title": "En mode 60"
    }
  ],
  "podcasts": [
    {
      "available": true,
      "description": "A true crime, creepy history and all things spooky podcast hosted by an autopsy technician and a hairstylist.",
      "fans": 10384,
      "id": "1520212",
      "link": "https://www.deezer.com/show/1520212",
      "picture_url": "https://cdn-images.dzcdn.net/images/talk/33beac8001fe315ef4ad4d2f09ad273a/1000x1000-000000-80-0-0.jpg",
      "title": "Morbid"
    }
  ],
  "tracks": [
    {
      "album": {
        "cover_url": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
        "id": "302127",
        "title": "Discovery"
      },
      "artist": {
        "id": "27",
        "link": "https://www.deezer.com/artist/27",
        "name": "Daft Punk"
      },
      "duration": "3:46",
      "duration_seconds": 226,
      "explicit": false,
      "id": "3135556",
      "link": "https://www.deezer.com/track/3135556",
      "preview_url": "https://cdnt-preview.dzcdn.net/api/1/1/6/a/2/0/6a2c0a56.mp3",
      "rank": 810329,
      "title": "Harder, Better, Faster, Stronger",
      "track_position": 4
    }
  ]
}
```

### Get the editors' picks

Read the albums Deezer's editors are currently picking out, for one genre or across all music.

**Inputs**

- Genre (`genre_id`, text): Which genre's picks to read. Leave it on 'All' for the overall selection. Default: `0`.

**Outputs**

- `albums` (list): The albums Deezer's editors are picking out
- `genre_id` (text): The genre these picks cover; 0 is all music
- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `total` (number): How many records match in total, across every page

**Example output**

```json
{
  "albums": [
    {
      "artist": {
        "id": "27",
        "link": "https://www.deezer.com/artist/27",
        "name": "Daft Punk"
      },
      "cover_url": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
      "explicit": false,
      "fans": 339905,
      "id": "302127",
      "link": "https://www.deezer.com/album/302127",
      "nb_tracks": 14,
      "record_type": "album",
      "release_date": "2001-03-07",
      "title": "Discovery"
    }
  ],
  "genre_id": "0",
  "has_more": false,
  "total": 10
}
```

### List genres

List Deezer's music genres with the id each one takes, so a step can pick a genre to chart or browse by name.

**Inputs**: None.

**Outputs**

- `genres` (list): Every genre Deezer files music under
- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `total` (number): How many records match in total, across every page

**Example output**

```json
{
  "genres": [
    {
      "id": "0",
      "name": "All",
      "picture_url": "https://cdn-images.dzcdn.net/images/misc//1000x1000-000000-80-0-0.jpg"
    },
    {
      "id": "132",
      "name": "Pop",
      "picture_url": "https://cdn-images.dzcdn.net/images/misc/db7a604d9e7634a67d45cfc86b48370a/1000x1000-000000-80-0-0.jpg"
    }
  ],
  "has_more": false,
  "total": 28
}
```

### Search albums

Search Deezer's catalogue for albums by title or artist, most relevant first.

**Inputs**

- Search for (`query`, text, required): What to search for. Free text, matched across titles and names, for example 'one more time daft punk'.
- How many results (`limit`, number): How many results to return (1-100). Deezer serves at most 100 per request. From 1 to 100. Default: `25`.
- Skip this many (`offset`, number): How many results to skip before returning any. Use it to read the next page: skip 25 to read results 26 onwards. From 0 to 10000. Default: `0`.

**Outputs**

- `albums` (list): The matching albums, most relevant first
- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `total` (number): How many records match in total, across every page

**Example output**

```json
{
  "albums": [
    {
      "artist": {
        "id": "27",
        "link": "https://www.deezer.com/artist/27",
        "name": "Daft Punk"
      },
      "cover_url": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
      "explicit": false,
      "fans": 339905,
      "id": "302127",
      "link": "https://www.deezer.com/album/302127",
      "nb_tracks": 14,
      "record_type": "album",
      "release_date": "2001-03-07",
      "title": "Discovery"
    }
  ],
  "has_more": true,
  "total": 42
}
```

### Search artists

Search Deezer's catalogue for artists by name, most relevant first. Use it to turn an artist's name into the id the other artist actions take.

**Inputs**

- Search for (`query`, text, required): What to search for. Free text, matched across titles and names, for example 'one more time daft punk'.
- How many results (`limit`, number): How many results to return (1-100). Deezer serves at most 100 per request. From 1 to 100. Default: `25`.
- Skip this many (`offset`, number): How many results to skip before returning any. Use it to read the next page: skip 25 to read results 26 onwards. From 0 to 10000. Default: `0`.

**Outputs**

- `artists` (list): The matching artists, most relevant first
- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `total` (number): How many records match in total, across every page

**Example output**

```json
{
  "artists": [
    {
      "id": "27",
      "link": "https://www.deezer.com/artist/27",
      "name": "Daft Punk",
      "nb_album": 38,
      "nb_fan": 5195690,
      "picture_url": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg"
    }
  ],
  "has_more": false,
  "total": 15
}
```

### Search playlists

Search Deezer's public playlists, both its editors' and other listeners', most relevant first.

**Inputs**

- Search for (`query`, text, required): What to search for. Free text, matched across titles and names, for example 'one more time daft punk'.
- How many results (`limit`, number): How many results to return (1-100). Deezer serves at most 100 per request. From 1 to 100. Default: `25`.
- Skip this many (`offset`, number): How many results to skip before returning any. Use it to read the next page: skip 25 to read results 26 onwards. From 0 to 10000. Default: `0`.

**Outputs**

- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `playlists` (list): The matching playlists, most relevant first
- `total` (number): How many records match in total, across every page

**Example output**

```json
{
  "has_more": true,
  "playlists": [
    {
      "creator": {
        "id": "1687950",
        "link": "",
        "name": "Alexandre - Pop & Hits Editor"
      },
      "duration": "2:31:39",
      "duration_seconds": 9099,
      "fans": 22559,
      "id": "908622995",
      "link": "https://www.deezer.com/playlist/908622995",
      "nb_tracks": 50,
      "picture_url": "https://cdn-images.dzcdn.net/images/playlist/4fd375a41c7779ed7deab64fb1194099/1000x1000-000000-80-0-0.jpg",
      "public": true,
      "title": "En mode 60"
    }
  ],
  "total": 156
}
```

### Search podcasts

Search the podcast shows on Deezer by title or subject, most relevant first.

**Inputs**

- Search for (`query`, text, required): What to search for. Free text, matched across titles and names, for example 'one more time daft punk'.
- How many results (`limit`, number): How many results to return (1-100). Deezer serves at most 100 per request. From 1 to 100. Default: `25`.
- Skip this many (`offset`, number): How many results to skip before returning any. Use it to read the next page: skip 25 to read results 26 onwards. From 0 to 10000. Default: `0`.

**Outputs**

- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `podcasts` (list): The matching shows, most relevant first
- `total` (number): How many records match in total, across every page

**Example output**

```json
{
  "has_more": true,
  "podcasts": [
    {
      "available": true,
      "description": "A true crime, creepy history and all things spooky podcast hosted by an autopsy technician and a hairstylist.",
      "fans": 10384,
      "id": "1520212",
      "link": "https://www.deezer.com/show/1520212",
      "picture_url": "https://cdn-images.dzcdn.net/images/talk/33beac8001fe315ef4ad4d2f09ad273a/1000x1000-000000-80-0-0.jpg",
      "title": "Morbid"
    }
  ],
  "total": 300
}
```

### Search tracks

Search Deezer's catalogue for tracks by title, artist or any mix of the two, most relevant first.

**Inputs**

- Search for (`query`, text, required): What to search for. Free text, matched across titles and names, for example 'one more time daft punk'.
- How many results (`limit`, number): How many results to return (1-100). Deezer serves at most 100 per request. From 1 to 100. Default: `25`.
- Skip this many (`offset`, number): How many results to skip before returning any. Use it to read the next page: skip 25 to read results 26 onwards. From 0 to 10000. Default: `0`.

**Outputs**

- `has_more` (true/false): Whether more records follow this page. Raise the skip to read them.
- `total` (number): How many records match in total, across every page
- `tracks` (list): The matching tracks, most relevant first

**Example output**

```json
{
  "has_more": true,
  "total": 162,
  "tracks": [
    {
      "album": {
        "cover_url": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg",
        "id": "302127",
        "title": "Discovery"
      },
      "artist": {
        "id": "27",
        "link": "https://www.deezer.com/artist/27",
        "name": "Daft Punk"
      },
      "duration": "3:46",
      "duration_seconds": 226,
      "explicit": false,
      "id": "3135556",
      "link": "https://www.deezer.com/track/3135556",
      "preview_url": "https://cdnt-preview.dzcdn.net/api/1/1/6/a/2/0/6a2c0a56.mp3",
      "rank": 810329,
      "title": "Harder, Better, Faster, Stronger",
      "track_position": 4
    }
  ]
}
```