Below, you’ll find some of our most frequently asked questions that we have gathered for developers. Discover everything you need to know about our Deezer API, using OAuth, the search endpoint and other related topics.
Jump to section:
Note: If you would like to discuss a potential partnership with us to integrate Deezer in hardware devices, vehicles or other products, you can contact us with this form
API
There is no paid API, but if you’d like to partner with Deezer, you can contact us with this form.
Speak to one of our Deezer Support representatives via Webchat between the hours of 09:30 and 17:00 GMT on weekdays and 11:00 until 17:00 GMT on weekends and they’ll be sure to get back to you.
Speak to one of our Deezer Support representatives via Webchat between the hours of 09:30 and 17:00 GMT on weekdays and 11:00 until 17:00 GMT on weekends and they’ll be sure to get back to you.
OAuth
No, this improvement is not planned.
It appears you are trying to make a call via JavaScript on another domain. If you’d like to use our API within a JavaScript implementation, please use our Javascript SDK.
Sorry, no. This is not planned for security reasons.
If you receive this type of error, when you try to add a track to a playlist (despite adding the manage_library permission) or when using search, your token may have expired.
Alternatively, it’s possible you’re performing a request to a private endpoint with the wrong token.
You’ll need to call the following URL: https://connect.deezer.com/oauth/auth.php?app_id=YOUR_APP_ID&redirect_uri=YOUR_REDIRECT_URI&perms=basic_access,email
Search endpoint
You just have to add the parameter “order=” at the end of your request and set a value defined in this list.
Example: https://api.deezer.com/search?q=eminem&order=DURATION_DESC
No, a query parameter is mandatory to perform a search.
No, this feature is not available.
We are trying our best to provide you with the most accurate results. Our search engine is continuously improving, but occasionally there may be some false positives.
No, there is no limitation on data in the API, but there is a query quota. Learn more here.
Some results, including podcast search, empty & untitled playlists, may show on PC, but not mobile. While our applications and APIs use Deezer’s core engine to retrieve result. There can be some differences in the results displayed because the outcome is not necessarily handled in the same way.
Other requests
Our Mixes are available from the endpoint: http://api.deezer.com/radio. You can learn more here.
Because of legal reasons, we can’t provide you with the audio file directly from our API. You will have to use our SDKs in this case. Jump to the JavaScript SDK section below.
You will find all the playlist and track information here.
If you would like to add songs to a playlist or add a playlist to your favorites, the request will look like this:
Example:
POST /user/me/playlists?access_token=XXXXXXXXXXXXXXXXXXXXX&playlist_id={{playlist_id}}
HTTP/1.1
Host api.deezer.com
Yes, it is possible.
No, images are not allowed to be stored for legal reasons.
You can use the JSONP response format described here.
No, this private information cannot be shared with developers.
No, this is not possible with Deezer’s API.
Javascript SDK
You can find our Javascript developers page here.
Please send us the errors related to our SDK that you can find in the Javascript console of your browser with this form.
There are two methods to perform these actions: "playPodcast" and "playEpisodes".
The SDK is a tool that allows you to interact with our service. It is meant to be implemented in your own integration, as long as it meets our Terms of use.
Please ensure the user is logged in. You can check with the "DZ.getLoginStatus" method detailed here.
The only restriction is related to the streaming of the tracks. You will only have access to 30 second previews.
No, our Native SDK has been deprecated and Deezer no longer supports it.
Developer guidelines: rules, rights and restrictions
You’ll find our T&Cs here.
Yes, you’ll find an overview of the streaming rights here.
Warning: Streaming rights can be updated at any time
We don’t deliver any certification for developers using our API and SDKs for commercial or non-commercial use.
This is not possible, unless there is a commercial agreement.
Our SDK is here to help you build the experience you want, but we don’t support the submission of your application.
In the “Edit” page of your application, in the “Basic info” section, you will find a label called “Activate”. Setting it to “false” will invalidate the tokens used by your application.