Getting Started

Welcome to Deezer developers website. Please find here everything you need to create your own Deezer experience, using the tools we are providing.

Where is Deezer available?

Deezer is available in 186 regions around the world. This list is updated on a weekly basis, we strongly advice you to regularly check newly opened regions:

What are Deezer requirements?

Please find find below requirements concerning technical aspects, features, UI, and user level management:

Deezer users access rules

https://developers.deezer.com/guidelines#content-access

Deezer logo guidelines

All the Deezer logo versions (black or white background, CMYK/RGB) are available here : https://developers.deezer.com/guidelines/logo
Warning Note that the respect of these requirements is mandatory. The usage of previous versions of Deezer logo (with curve & reflection) is strictly forbidden.

Deezer features guidelines

If your are a manufacturer or a firmware developer building a full branded Deezer application, you have to develop a minimum set of features to reach our agreement:
https://developers.deezer.com/guidelines#features
Any full branded Deezer application needs our previous agreement.

Resources

Deezer offers you a set of tools/resources to help you create a jaw-dropping application.

Deezer API Explorer

Deezer API Explorer is a web-based tool to explore and to test API queries :
https://developers.deezer.com/api/explorer

SDK Sample Projects

Each SDK contains a sample project to help you getting started:

Android Sample project :
https://developers.deezer.com/sdk/android#using-player-module
OS Sample project :
https://developers.deezer.com/sdk/ios#intro
Javascript Samples :
- SDK Javascript sample using the deezer widget player :
  https://developers.deezer.com/sdk/javascript/example-basic
- SDK Javascript sample using a custom player :
  https://developers.deezer.com/sdk/javascript/example-invisible

Deezer UI Kit

Deezer gives you access to all icons and graphical resources (PSD) to create a Deezer-like experience.
https://developers.deezer.com/guidelines/ui-kit
Unlike logo usage, the Deezer UI Kit is not mandatory.

Setup a project

Common

0) Go to Deezer developers website: https://developers.deezer.com
1) Login with your standard Deezer account, and go to My App.
2) Create an application id for your project by clicking on "Create a new application" button
3) Fill in the app creation form and validate. You can edit your application later to add additional informations.

Warning The domain field is useful only for web-based applications.
Please fill in the domain without http://www. (e.g. mydomain.com)

Javascript web-based aplication

4) Use your newly created application id and your domain in the Javascript example (https://developers.deezer.com/sdk/javascript ) to replace YOUR_APP_ID and YOUR_DOMAIN with yours.

Warning If the Deezer OAuth popup displays the following message : "You must enter a valid redirect uri", please check the domain informations of your application.

Android application

4) Edit your newly created application by clicking on My Apps, then your application name and then "Edit application".
5) Under the "Android application" tab (click to unfold), please specify your Android package name.(mandatory)
The Google Play url is not mandatory and will only be necessary for the application promotion section described below.

iOS

4) Edit your newly created application by clicking on My Apps, then your application name and then "Edit application".
5) Under the "iOS application" tab (click to unfold), please specify your iOS package name.(mandatory)
The iTunes url is not mandatory and will be necessary for the application promotion section described below.