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. Software development kits
- 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.
"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.
"Do you plan to improve OAuth2 support?"
No, this improvement is not planned.
"My authentication token request is blocked because of CORS. Why?"
"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?"
"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:
"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.
VI. Software developer kits
"Where can I find Deezer’s Android developers page?"
You can find our Android developers page here.
"How can I play a Mix?”
You can use our “RadioPlayer” player and follow the sample available here.
"Why am I getting only 30s previews (despite having a Premium account)?"
This may happen if you are not completely authenticated. Please make sure that you’re logged in and that your user session is stored properly. Learn more here.
"Why are some users getting a 'NotAllowedToPlayThatSongException' when calling the method playTrack(long trackId) from TrackPlayer class?"
This exception is thrown when a song is played, but the current user doesn't have the necessary rights to listen to it. For example, the user is based in a country where the track is unavailable.
"Why do I need to run the auth every 60 minutes?"
It is a security limitation, so the access token has to be renewed regularly.
"Does the SDK run on Android 9?"
Yes, our SDK works on Android 9.
"Where can I find your iOS Developers page?"
You can find our iOS developers page here.
"How can I play a Mix?"
You just have to instantiate the playable object “DZRRadios” and send it to the “DZRPlayer” as described here.
"Could you remove UIWebView from the SDK (and use WKWebView instead) as it is no longer accepted by Apple (deprecated)?"
Our latest version of the SDK no longer imports “UIWebView”. You can download it here.
"The SDK seems to be broken. What is going wrong?"
"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?"
"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.
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.