Skip to main content

A friendly wrapper library for the Deezer API

Project description

Deezer Python Client

Build status Test coverage percentage Documentation Status PyPi Status Code Health pyversions license

A friendly wrapper around the Deezer API.


The package is published on the Python index simply run the following:

pip install deezer-python

And that’s it!

Basic Use

So far you can only retrieve the data for the public objects, for which no login is required. The objects are translated to python resources, which are basically python objects encapsulating the json dictionary returned by the API.

>>> client = deezer.Client()
>>> client.get_album(12).title
u'Monkey Business'

You also can use AsyncClient with tornado.

>>> from tornado.gen import coroutine
>>> from tornado.ioloop import IOLoop
>>> from deezer import AsyncClient
>>> @coroutine
... def main():
...     client = AsyncClient()
...     album = yield client.get_album(12)
...     print(album.title)
>>> IOLoop.instance().run_sync(main)
Monkey Business

See the whole API on the Sphinx generated documentation.


Not supported by this package. There are excellent other python modules to handle that. There is the excellent Python Social Auth, which supports Deezer authentication.


0.6.1 (2017-06-19)

  • Added access token to the request kwargs. Thanks Nikolay Sheregeda for the patch.
  • Documentation update, thanks Khamaileon for the correction.

0.6.0 (2016-12-27)

  • Refactoring to use requests instead of urllib, mocking using Requests mock instead of manual patching. Use six for Python 2 and 3 compatibility.

0.5.0 (2016-12-26)

  • Python 3.6 support
  • Remove Python 3.2 classifier, support was dropped since 0.2.3
  • Updated docs and testing setup

0.4.0 (2016-12-08)

  • Add the chart resource. Thanks to Pascal.
  • Documentation updates regarding changelog and list of authors.

0.3.0 (2016-11-09)

  • Enriching the API for resources to get related resources as iterators. Thanks to Pascal.

0.2.3 (2016-11-07)

  • Drop support for Python 3.2. It should still work, but we are not testing it anymore, as this version as reached end of life.

0.2.2 (2015-09-14)

  • Python 3.5 support
  • Various doc updates

0.2.0 (2015-01-31)

  • Enriching the API for resources to get artists for a genre, top tracks of an artist, etc… Thanks to Misuzu.

0.1.0 (2014-11-22)

  • Initial release.


“deezer-python” is written and maintained by Bruno Alla.


Other people contributed to this project:

Please add yourself here alphabetically when you submit your first pull request.

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
deezer_python-0.6.1-py2-none-any.whl (11.0 kB) Copy SHA256 hash SHA256 Wheel py2 Jun 19, 2017
deezer-python-0.6.1.tar.gz (40.7 kB) Copy SHA256 hash SHA256 Source None Jun 19, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page