Deezer
Deezer API reference: 36 endpoints for tracks, lyrics, artists, albums, charts and podcasts. Per-endpoint credit prices and cURL examples.
Deezer tracks and lyrics, artists, albums, playlists, charts, radios, podcasts, concerts, ISRC and UPC lookups and search.
Base path: /v1/deezer/...
Quickstart
curl "https://api.insightsocial.app/v1/deezer/album?album_id=302127" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
4 of these are metered: the price depends on how much the call reads. See Credits.
Every endpoint here is beta: it returns the platform's own structure under our naming rules (snake_case keys, string ids, ISO times where the platform gives a timestamp), not a schema-2 entity, and its fields may change. See Beta endpoints.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/album | 20 | Get a Deezer album with its label, barcode, copyright lines, credits and every track. Beta. | album_id |
/albums | 20–2500 | Get up to 200 Deezer albums in one request; ids that match nothing are listed. Beta. | ids |
/albums/upc | 20 | Get a Deezer album from its UPC or EAN barcode, with the same fields as the album lookup. Beta. | upc |
/artist | 20 | Get a Deezer artist with fans, biography, links, banner, names in other scripts and featured playlists. Beta. | artist_id |
/artist/albums | 20 | List a Deezer artist's releases or appearances. Beta. | artist_id |
/artist/events | 20 | List upcoming Deezer artist concerts and festivals. Beta. | artist_id |
/artist/mix | 20 | Get a Deezer mix of tracks by an artist and similar artists. Beta. | artist_id |
/artist/playlists | 20 | List the playlists that feature a Deezer artist, up to 100. Beta. | artist_id |
/artist/related | 20 | List up to 40 artists Deezer relates to an artist. Beta. | artist_id |
/artist/top-tracks | 20 | List a Deezer artist's most played tracks, up to 100. Beta. | artist_id |
/artists | 20–2500 | Get up to 200 Deezer artists in one request; ids that match nothing are listed. Beta. | ids |
/charts | 20 | Get a Deezer chart of tracks, albums, artists, playlists or podcasts, with a country for the tracks chart. Beta. | — |
/episode | 20 | Get a Deezer podcast episode with the publisher's own audio link. Beta. | episode_id |
/event | 20 | Get one upcoming Deezer concert or festival with venue and artists. Beta. | event_id |
/events | 20 | Search upcoming Deezer concerts and festivals by place or act. Beta. | — |
/genre/artists | 20 | List the artists Deezer features in a genre, up to 50. Beta. | genre_id |
/genres | 20 | List every Deezer genre, named in the language you ask for. Beta. | — |
/oembed | 20 | Get the embed code and thumbnail for a Deezer track, album, playlist, podcast or episode page URL. Beta. | url |
/pages | 20 | Get one of Deezer's editorial pages (home, charts, moods, genres, radios, podcasts or a channel) as sections of items. Beta. | — |
/playlist | 20 | Get a Deezer playlist's details. Beta. | playlist_id |
/playlist/tracks | 20 | List a Deezer playlist's tracks in order with the date each was added, up to 1,000 per page. Beta. | playlist_id |
/playlists | 20–2500 | Get up to 200 public Deezer playlists in one request; ids that match nothing are listed. Beta. | ids |
/radio/tracks | 20 | Get about 25 tracks from a Deezer radio. Beta. | radio_id |
/radios | 20 | List Deezer's genre and mood radios, or those of one genre. Beta. | — |
/search | 20 | Search Deezer for tracks, artists, albums, playlists, podcasts, episodes, radio stations and accounts. Beta. | query |
/show | 20 | Get a Deezer podcast show with its publisher, description, episode count and availability. Beta. | show_id |
/show/episodes | 20 | List the episodes of a Deezer podcast show, newest first, with paging. Beta. | show_id |
/station | 20 | Get an internet radio station on Deezer with the station's own stream links by bit rate. Beta. | station_id |
/track | 20 | Get a Deezer track with its credits, copyright, rights, countries, other releases and a 30 second preview link. Beta. | track_id |
/track/lyrics | 20 | Get a track's lyrics with line and word timings, writers, copyright and licence, or none when Deezer shows no lyrics. Beta. | track_id |
/tracks | 20–2500 | Get up to 200 Deezer tracks in one request; ids that match nothing are listed. Beta. | ids |
/tracks/isrc | 20 | Get a Deezer track from its ISRC recording code, with the same fields as the track lookup. Beta. | isrc |
/user | 20 | Get the public profile of a Deezer account: display name, country and picture. Beta. | user_id |
/user/connections | 20 | List the accounts that follow a Deezer account, or that it follows. Beta. | user_id, kind |
/user/library | 20 | List a Deezer account's favourite albums, artists or tracks. Beta. | user_id, kind |
/user/playlists | 20 | List a Deezer account's public playlists. Beta. | user_id |