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
Can I use the API for commercial purposes? Is there a paid API?
There is no paid API, but if you’d like to partner with Deezer, you can contact us with this form.
I noticed an API endpoint is missing. What can I do?
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.
What should I do if I notice an existing API endpoint is not up to date?
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
Do you plan to improve OAuth2 support?
No, this improvement is not planned.
My authentication token request is blocked because of CORS. Why?
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.
Why do I receive an OAuthException error?
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.
How should I handle the login dialog?
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
Could you add the possibility to define multiple redirect URIs?
Sorry, no. This is not planned for security reasons.
Search endpoint
How should I use the order feature?
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
Is it possible to search without a query only using order and parameters?
No, a query parameter is mandatory to perform a search.
Is it possible to search in multiple labels?
No, this feature is not available.
Why doesn’t a partial or incomplete query return results?
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.
Is there a limitation on the amount of data returned by the API?
No, there is no limitation on data in the API, but there is a query quota. Learn more here.
Some results are showing on PC but not on mobile. Why?
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
Is it possible to use Mixes? If so, what request should be sent?
Our Mixes are available from the endpoint: http://api.deezer.com/radio. You can learn more here.
Why am I getting only 30 second previews via the API despite having a Premium account?
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.
How can I add or delete songs from a playlist?
You will find all the playlist and track information here.
Can I get an example of a POST request?
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
Is it possible to store artist and track names locally without stocking the audio?
Yes, it is possible.
Can I store Deezer images as cache?
No, images are not allowed to be stored for legal reasons.
How can I send a JSON request (for album covers) without getting a CORS error?
You can use the JSONP response format described here.
Can I get the number of male or female fans of an artist?
No, this private information cannot be shared with developers.
Can we create a bridge between our payment platform and the Deezer API?
No, this is not possible with Deezer’s API.
Javascript SDK
Where can I find Deezer’s Javascript developers page?
You can find our Javascript developers page here.
The SDK seems to be broken. What is going wrong?
Please send us the errors related to our SDK that you can find in the Javascript console of your browser with this form.
How can I play podcasts and podcast episodes?
There are two methods to perform these actions: "playPodcast" and "playEpisodes".
Am I allowed to add a custom functionality of my own onto the Deezer Player?
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.
Why am I getting only 30 second previews after a refresh despite having a Premium account?
Please ensure the user is logged in. You can check with the "DZ.getLoginStatus" method detailed here.
Are there restrictions on playing music on iOS devices from a website built with the Javascript SDK?
The only restriction is related to the streaming of the tracks. You will only have access to 30 second previews.
Is your Native SDK still available?
No, our Native SDK has been deprecated and Deezer no longer supports it.
Developer guidelines: rules, rights and restrictions
What are Deezer's Terms & Conditions for developers?
You’ll find our T&Cs here.
Is there a table of rights?
Yes, you’ll find an overview of the streaming rights here.
Warning: Streaming rights can be updated at any time
How can I get an approval, a certification, or a license to use the Deezer API, a Deezer feature, or Deezer’s content in a third-party app?
We don’t deliver any certification for developers using our API and SDKs for commercial or non-commercial use.
Can my third-party app be whitelisted to avoid API limitations?
This is not possible, unless there is a commercial agreement.
I need documentation from Deezer to publish a third-party app on the App Store. Where can I find it?I need documentation from Deezer to publish a third-party app on the App Store. Where can I find it?
Our SDK is here to help you build the experience you want, but we don’t support the submission of your application.
How can I delete an app from Deezer Developers?
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.