Deezer

App · Music & Podcasts · 20 actions

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.

Actions

ActionWhat it does
Get a playlistRead one public playlist: who made it, what it is for, how long it runs and how many people follow it.
Get a podcast episodeRead one podcast episode in full, including the show notes that the episode listing leaves out.
Get a trackRead 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.
Get album tracksList an album's track listing, in running order.
Get an albumRead one album in full: its artist, label, genres, release date, running time and how many people have favourited it.
Get an artistRead one artist: their picture, how many releases they have and how many listeners follow them.
Get an artist's albumsList an artist's releases, newest first, each marked as an album, single, EP or compilation.
Get an artist's radio mixBuild a mix of tracks around one artist: their own songs blended with ones Deezer thinks sit alongside them.
Get an artist's top tracksList an artist's most popular tracks on Deezer, most popular first.
Get playlist tracksList a public playlist's tracks, in playlist order.
Get podcast episodesList a podcast show's episodes, newest first, with each one's publication date and running time.
Get related artistsList the artists Deezer considers similar to this one, for building a recommendation out of one seed artist.
Get the chartsRead what is charting on Deezer right now: the top tracks, albums, artists, playlists and podcasts, for one genre or across all music.
Get the editors' picksRead the albums Deezer's editors are currently picking out, for one genre or across all music.
List genresList Deezer's music genres with the id each one takes, so a step can pick a genre to chart or browse by name.
Search albumsSearch Deezer's catalogue for albums by title or artist, most relevant first.
Search artistsSearch Deezer's catalogue for artists by name, most relevant first.
Search playlistsSearch Deezer's public playlists, both its editors' and other listeners', most relevant first.
Search podcastsSearch the podcast shows on Deezer by title or subject, most relevant first.
Search tracksSearch Deezer's catalogue for tracks by title, artist or any mix of the two, most relevant first.

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

Playlistplaylist_idtextRequired
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

collaborativetrue/false
Whether other people may add to it
created_attext
When it was created, as an ISO 8601 timestamp
creatorobject
Who put the playlist together
descriptiontext
What its creator says it is for
durationtext
How long it runs in total, written as h:mm:ss
duration_secondsnumber
How long it runs in total, in seconds
fansnumber
How many people follow it
idtext
The playlist's Deezer id
linktext
Link to the playlist on Deezer
nb_tracksnumber
How many tracks it holds
picture_urltext
Link to the playlist artwork
publictrue/false
Whether anyone can see it
titletext
The playlist title
updated_attext
When it last changed, as an ISO 8601 timestamp
Example output
{
  "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

Episodeepisode_idtextRequired
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

availabletrue/false
Whether Deezer can play it in your country
descriptiontext
The episode's show notes
durationtext
How long it runs, written as m:ss or h:mm:ss
duration_secondsnumber
How long it runs, in seconds
idtext
The episode's Deezer id
linktext
Link to the episode on Deezer
picture_urltext
Link to the episode artwork
podcastobject
The show the episode belongs to
released_attext
When it was published, as an ISO 8601 timestamp
titletext
The episode title
Example output
{
  "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

Tracktrack_idtextRequired
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

albumobject
The album the track appears on
artistobject
The artist, as a reference you can pass to the artist actions
bpmnumber
Its tempo in beats per minute, to two decimal places, when Deezer has measured it
contributorslist
Every credited artist, the main one first
disk_numbernumber
Which disc of the album it sits on
durationtext
How long the track runs, written as m:ss
duration_secondsnumber
How long the track runs, in seconds
explicittrue/false
Whether the lyrics are flagged explicit
idtext
The track's Deezer id
isrctext
The recording's ISRC, the industry code that identifies it across services
linktext
Link to the track on Deezer
preview_urltext
Link to a 30-second MP3 preview
ranknumber
Deezer's popularity score for the track, 0 to 1,000,000
release_datetext
When it was released, as YYYY-MM-DD
titletext
The track title
track_positionnumber
Its position on its album, when the listing says
Example output
{
  "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

Albumalbum_idtextRequired
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 resultslimitnumber
How many results to return (1-100). Deezer serves at most 100 per request.From 1 to 100. Default: 50.
Skip this manyoffsetnumber
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_moretrue/false
Whether more records follow this page. Raise the skip to read them.
totalnumber
How many records match in total, across every page
trackslist
The album's tracks, in running order
Example output
{
  "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

Albumalbum_idtextRequired
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

artistobject
The artist, as a reference you can pass to the artist actions
availabletrue/false
Whether Deezer can play it in your country
contributorslist
Every credited artist, the main one first
cover_urltext
Link to the album artwork
durationtext
How long the album runs, written as h:mm:ss
duration_secondsnumber
How long the album runs, in seconds
explicittrue/false
Whether any of its lyrics are flagged explicit
fansnumber
How many people have favourited it
genreslist
The genres Deezer files it under
idtext
The album's Deezer id
labeltext
The record label that released it
linktext
Link to the album on Deezer
nb_tracksnumber
How many tracks it holds
record_typetext
What kind of release: album, single, ep or compilation
release_datetext
When it was released, as YYYY-MM-DD
titletext
The album title
upctext
The release's UPC barcode
Example output
{
  "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

Artistartist_idtextRequired
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_radiotrue/false
Whether Deezer offers a radio station built around this artist
idtext
The artist's Deezer id
linktext
Link to the artist on Deezer
nametext
The artist's name
nb_albumnumber
How many releases they have
nb_fannumber
How many people follow them
picture_urltext
Link to the artist's picture
Example output
{
  "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

Artistartist_idtextRequired
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 resultslimitnumber
How many results to return (1-100). Deezer serves at most 100 per request.From 1 to 100. Default: 25.
Skip this manyoffsetnumber
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

albumslist
The artist's releases, newest first
has_moretrue/false
Whether more records follow this page. Raise the skip to read them.
totalnumber
How many records match in total, across every page
Example output
{
  "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

Artistartist_idtextRequired
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 resultslimitnumber
How many results to return (1-100). Deezer serves at most 100 per request.From 1 to 100. Default: 25.

Outputs

has_moretrue/false
Whether more records follow this page. Raise the skip to read them.
totalnumber
How many records match in total, across every page
trackslist
The mix Deezer builds around the artist, in play order
Example output
{
  "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

Artistartist_idtextRequired
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 resultslimitnumber
How many results to return (1-100). Deezer serves at most 100 per request.From 1 to 100. Default: 25.
Skip this manyoffsetnumber
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_moretrue/false
Whether more records follow this page. Raise the skip to read them.
totalnumber
How many records match in total, across every page
trackslist
The artist's tracks, most popular first
Example output
{
  "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

Playlistplaylist_idtextRequired
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 resultslimitnumber
How many results to return (1-100). Deezer serves at most 100 per request.From 1 to 100. Default: 50.
Skip this manyoffsetnumber
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_moretrue/false
Whether more records follow this page. Raise the skip to read them.
totalnumber
How many records match in total, across every page
trackslist
The playlist's tracks, in playlist order
Example output
{
  "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

Podcastpodcast_idtextRequired
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 resultslimitnumber
How many results to return (1-100). Deezer serves at most 100 per request.From 1 to 100. Default: 25.
Skip this manyoffsetnumber
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

episodeslist
The show's episodes, newest first
has_moretrue/false
Whether more records follow this page. Raise the skip to read them.
totalnumber
How many records match in total, across every page
Example output
{
  "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
}

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

Inputs

Artistartist_idtextRequired
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 resultslimitnumber
How many results to return (1-100). Deezer serves at most 100 per request.From 1 to 100. Default: 25.
Skip this manyoffsetnumber
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

artistslist
Artists Deezer considers similar
has_moretrue/false
Whether more records follow this page. Raise the skip to read them.
totalnumber
How many records match in total, across every page
Example output
{
  "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

Genregenre_idtext
Which genre to chart. Leave it on 'All' for the overall charts.Default: 0.
Which chartslistslist
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 chartlimitnumber
How many entries to return in each chart (1-100).From 1 to 100. Default: 10.

Outputs

albumslist
The top albums, highest charting first
artistslist
The top artists, highest charting first
genre_idtext
The genre these charts cover; 0 is all music
playlistslist
The top playlists, highest charting first
podcastslist
The top podcasts, highest charting first
trackslist
The top tracks, highest charting first
Example output
{
  "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
    }
  ]
}

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

Inputs

Genregenre_idtext
Which genre's picks to read. Leave it on 'All' for the overall selection.Default: 0.

Outputs

albumslist
The albums Deezer's editors are picking out
genre_idtext
The genre these picks cover; 0 is all music
has_moretrue/false
Whether more records follow this page. Raise the skip to read them.
totalnumber
How many records match in total, across every page
Example output
{
  "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

genreslist
Every genre Deezer files music under
has_moretrue/false
Whether more records follow this page. Raise the skip to read them.
totalnumber
How many records match in total, across every page
Example output
{
  "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 forquerytextRequired
What to search for. Free text, matched across titles and names, for example 'one more time daft punk'.
How many resultslimitnumber
How many results to return (1-100). Deezer serves at most 100 per request.From 1 to 100. Default: 25.
Skip this manyoffsetnumber
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

albumslist
The matching albums, most relevant first
has_moretrue/false
Whether more records follow this page. Raise the skip to read them.
totalnumber
How many records match in total, across every page
Example output
{
  "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 forquerytextRequired
What to search for. Free text, matched across titles and names, for example 'one more time daft punk'.
How many resultslimitnumber
How many results to return (1-100). Deezer serves at most 100 per request.From 1 to 100. Default: 25.
Skip this manyoffsetnumber
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

artistslist
The matching artists, most relevant first
has_moretrue/false
Whether more records follow this page. Raise the skip to read them.
totalnumber
How many records match in total, across every page
Example output
{
  "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 forquerytextRequired
What to search for. Free text, matched across titles and names, for example 'one more time daft punk'.
How many resultslimitnumber
How many results to return (1-100). Deezer serves at most 100 per request.From 1 to 100. Default: 25.
Skip this manyoffsetnumber
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_moretrue/false
Whether more records follow this page. Raise the skip to read them.
playlistslist
The matching playlists, most relevant first
totalnumber
How many records match in total, across every page
Example output
{
  "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 forquerytextRequired
What to search for. Free text, matched across titles and names, for example 'one more time daft punk'.
How many resultslimitnumber
How many results to return (1-100). Deezer serves at most 100 per request.From 1 to 100. Default: 25.
Skip this manyoffsetnumber
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_moretrue/false
Whether more records follow this page. Raise the skip to read them.
podcastslist
The matching shows, most relevant first
totalnumber
How many records match in total, across every page
Example output
{
  "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 forquerytextRequired
What to search for. Free text, matched across titles and names, for example 'one more time daft punk'.
How many resultslimitnumber
How many results to return (1-100). Deezer serves at most 100 per request.From 1 to 100. Default: 25.
Skip this manyoffsetnumber
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_moretrue/false
Whether more records follow this page. Raise the skip to read them.
totalnumber
How many records match in total, across every page
trackslist
The matching tracks, most relevant first
Example output
{
  "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
    }
  ]
}

On this page