Deezer Simple API provides a nice set of services to build up web applications allowing the discovery of Deezer’s music catalogue.
https://dribbble.com/oauth/authorize
Parameters:
app_id - The id of your application, generated when you created your application on developer page..
redirect_uri - The URL the user will be redirected after authentication. redirect_uri must be in the same domain as the domain you defined when you created the application.
perms - The permissions your application will ask to the user.
getAccessToken
block.Datatype | Description | Example |
---|---|---|
Datepicker | String which includes date and time | |
Map | String which includes latitude and longitude coma separated | |
List | Simple array | |
Select | String with predefined values | |
Array | Array of objects |
Returns access token.
Field | Type | Description |
---|---|---|
appId | credentials | The id of your application, generated when you created your application on developer page. |
appSecret | credentials | The app secret is available from the Application setting page and should not be shared with anyone or embedded in any code that you will distribute (you should use the client-side flow for these scenarios). |
code | credentials | The code you received at the previous step. |
output | Select | The way you want to output the access_token. If not specifed, this will output the access_token as a string to parse (like in the example below) |
Return a list of album’s comments. Represented by an array of Comment objects.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
albumId | String | The Deezer album id. |
Return a list of album’s fans. Represented by an array of User objects.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
albumId | String | The Deezer album id. |
Return a list of album’s tracks. Represented by an array of Track objects.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
albumId | String | The Deezer album id. |
Get the top 5 tracks of an artist.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
artistId | String | The artist’s Deezer id. |
Return a list of artist’s albums. Represented by an array of Album objects.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
artistId | String | The artist’s Deezer id. |
Return a list of artist’s comments. Represented by an array of Comment objects.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
artistId | String | The artist’s Deezer id. |
Return a list of artist’s fans. Represented by an array of User objects.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
artistId | String | The artist’s Deezer id. |
Return a list of related artists. Represented by an array of Artist objects
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
artistId | String | The artist’s Deezer id. |
Return a list of tracks. Represented by an array of Track object.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
artistId | String | The artist’s Deezer id. |
Return a list of artist’s playlists. Represented by an array of Playlist object.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
artistId | String | The artist’s Deezer id. |
Returns the Top tracks.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
Returns the Top albums.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
Returns the Top artists.
No arguments.
Returns the Top playlists.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
Return a list of albums selected every week by the Deezer Team.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
This method returns four lists : Top track, Top album, Top artist and Top playlist.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
This method returns the new releases per genre for the current country.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
Returns all artists for a genre.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
Returns all radios for a genre
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
Get the user’s options.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
Return a list of playlist’s comments. Represented by an array of Comment objects
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
playlistId | String | The playlist’s Deezer id. |
Return a list of playlist’s fans. Represented by an array of User objects.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
playlistId | String | The playlist’s Deezer id. |
Return a list of playlist’s tracks. Represented by an array of Track object.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
playlistId | String | The playlist’s Deezer id. |
Returns a list of radio splitted by genre.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
Return the top radios (5 radios)
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
Get first 40 tracks in the radio
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
Returns a list of personal radio splitted by genre (as MIX in website)
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
Search albums.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
searchQuery | String | Search string. |
Search artists.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
searchQuery | String | Search string. |
Get user search history.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
searchQuery | String | Search string. |
Search playlists.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
searchQuery | String | Search string. |
Search radio.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
searchQuery | String | Search string. |
Search tracks.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
searchQuery | String | Search string. |
Search users.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
searchQuery | String | Search string. |
Return a list of user’s favorite albums. Represented by an array of Album object
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
Return a list of user’s favorite artists. Represented by an array of Artist object
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
Returns a list of user’s flow tracks, represented by an array of Track object.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Return a list of user’s Folder.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Return a list of user’s following, represented by an array of User object
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Return a list of user’s followers, represented by an array of User object
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Returns a list of the recently played tracks.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Use this method in post only, to add notifications in user feed.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Return the user’s Permissions granted to the application.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Return a list of user’s personnal song, represented by an array of Tracks.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Return a list of user’s public Playlist, represented by an array of Playlist object. Permission is needed to return private playlists.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Return a list of user’s favorite Radios, represented by an array of Radio object.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Return a list of user’s favorite tracks. Represented by an array of Track object.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Return a list of user’s recommendations albums.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Return a list of user’s recommendations artists.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Return a list of user’s recommendations playlists.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Return a list of user’s recommendations tracks.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Return a list of user’s recommendations radios.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
Add a comment to the album.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
albumId | String | User id. |
comment | String | The content of the comment. |
Add a comment to the artist.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
artistId | String | Artist id. |
comment | String | The content of the comment. |
Sets a bookmark on the episode.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
episodeId | String | Artist id. |
offset | Number | The offset where the bookmark is set, must be between 0 and 100. |
Rename the folder.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
folderId | String | Folder id. |
title | String | The new title of the folder. |
Add a playlist to the folder.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
folderId | String | Folder id. |
playlistId | String | The playlist id. |
Add an album to the folder.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
folderId | String | Folder id. |
albumId | String | The album id. |
Rate the playlist.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
playlistId | String | Playlist id. |
note | String | An int [1-5]. |
Update the playlist.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
playlistId | String | Playlist id. |
Mark the playlist as seen.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
playlistId | String | Playlist id. |
Add a comment to the playlist.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
playlistId | String | Playlist id. |
comment | String | The content of the comment. |
Add a track to the playlist.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
playlistId | String | Playlist id. |
songs | String | A comma separated list of track ids. |
Order tracks in the playlist.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
playlistId | String | Playlist id. |
order | String | A comma separated list of track ids. |
Update a personal track.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
trackId | String | Track id. |
Add an album to the user’s library.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
albumId | String | The id of the album. |
Add an artist to the user’s favorites.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
artistId | String | The id of the artist. |
Create a folder.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
title | String | The title of the folder. |
Follow user.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
followingUser | String | The user id to follow. |
Create a playlist.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
title | String | The title of the new playlist. |
Add a playlist to the user’s favorites.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
playlistId | String | The playlist id. |
Add a podcast to the user’s favorites.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
podcastId | String | The podcast id. |
Add a radio to the user’s favorites.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
radioId | String | The radio id. |
Add a track to the user’s favorites.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | User id. |
trackId | String | The id of the track. |
Remove a comment.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
commentId | String | Comment id. |
Removes the bookmark on the episode.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
episodeId | String | Episode id. |
Delete the folder.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
folderId | String | Folder id. |
Remove a playlist from the folder.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
folderId | String | Folder id. |
playlistId | String | The playlist id. |
Remove an album from the folder.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
folderId | String | Folder id. |
albumId | String | The album id. |
Delete the playlist.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
playlistId | String | The playlist id. |
Delete the playlist.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
playlistId | String | The playlist id. |
songs | String | A comma separated list of track ids. |
Delete a personal track.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
trackId | String | The track id. |
Remove an album from the user’s library.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | The user id. |
albumId | String | The album id. |
Remove an artist from the user’s favorites.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | The user id. |
artistId | String | The artist id. |
Unfollow user.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | The user id. |
user | String | The user id. |
Remove a playlist from the user’s favorites.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | The user id. |
playlistId | String | The playlist id. |
Remove a podcast from the user’s favorites.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | The user id. |
podcastId | String | The podcast id. |
Remove a radio from the user’s favorites.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | The user id. |
radioId | String | The podcast id. |
Remove a track from the user’s favorites.
Field | Type | Description |
---|---|---|
accessToken | credentials | Your access token. |
userId | String | The user id. |
trackId | String | The podcast id. |