Below, you’ll find some of our most frequently asked questions, which we've gathered for developers. Discover everything you need to know about our API, using OAuth, search endpoint and other related topics. Use the menu below to jump to the relevant information:
- I. API
- II. OAuth
- III. Search endpoint
- IV. Other requests
- V. Javascript SDK
- VI. Developer guidelines: rules, rights and restrictions
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.
I. 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?"
If you’ve spotted an API endpoint that is missing (e.g. Flow, new releases, currently playing track, audiostream/data, genre names in any supported language, number of plays for a track, etc.), feel free to contact us with this form.
We’ll review your request and consider implementing it to improve our user experience.
"What should I do if I notice an existing API endpoint is not up to date?"
If you’ve noticed that an existing API endpoint is out of date (e.g. add release_date for album requests, include podcasts in user/me/history, add track ISRCs in playlist endpoint, add desc to playlist on playlist creation), please let us know with this form.
"Are Deezer HiFi and Deezer Family supported in the API?"
Unfortunately, Deezer HiFi and Deezer Family are not available in our public API.
II. 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 our API in a JavaScript implementation, please use our Javascript SDK.
"Could you add the possibility to define multiple redirect URIs?"
Sorry, no. This is not planned for security reasons.
"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 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:
III. 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 detailed here.
"Is it possible to search without a query (only using order & 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/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 results, there can be some differences in the results displayed, as the outcome is not necessarily handled in the same way.
IV. 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.
Learn more here.
"Why am I getting only 30s 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 (see section below).
"How can I add/delete songs to/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:
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/female fans of an artist?"
No, this private information cannot be shared with developers.
"What’s the difference between ‘Loved tracks’ playlist and user/me/tracks?"
There is no difference. It is the same playlist/tracklist.
"Can we create a bridge between our payment platform and Deezer API? How?"
No, this is not possible with Deezer’s API.
V. Javascript SDK
"Where can I find Deezer’s Javascript developer’s 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 30s 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 to play 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.
VI. 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.
Note: Streaming rights can be updated at any time without warning
"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?"
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.