CHANGELOG¶

v7.3.0 (2026-04-06)¶

Features¶

Add async deezer client and resources in deezer.asyncio (cf30c7c)

v7.2.0 (2025-09-18)¶

Features¶

Add support for python 3.14 (81adb2e)
Drop support for python 3.9 (cd837d2)

v7.1.2 (2025-08-25)¶

Bug fixes¶

Use spdx expression for license (858793a)

v7.1.1 (2024-12-20)¶

Documentation¶

Add tdambrin as a contributor for bug (125ff85)

Bug fixes¶

No forward parent when getting artist radio (6807997)

v7.1.0 (2024-10-31)¶

Features¶

Drop support for python 3.8 (ee076f0)
Drop support for python 3.8 (ee076f0)

v7.0.0 (2024-07-11)¶

Refactoring¶

Make query params more explicit (553df43)
Remove unused app_id and app_secret client parameters (c1bbf37)

Features¶

Add custom auth class for httpx (e8d1955)
Migrate from requests to httpx (06e20d8)

Testing¶

Separate client fixtures to avoid leaking auth to non-auth (81f11bf)
Simplify mocked responses (6df900f)

Documentation¶

Update language for python repl blocks (09b7c87)
Update language for python repl blocks (f66dec4)

v6.1.1 (2023-10-18)¶

Bug fixes¶

Potential unset response attribute on httperror (82a47be)

Documentation¶

Fix grammar in docstring (9ed3032)

v6.1.0 (2023-08-07)¶

Features¶

Add official support for python 3.12 (2eead31)

Documentation¶

Switch to furo theme (51cfb08)
Switch to furo theme (51cfb08)
Remove templates and rtd theme mention (51cfb08)

v6.0.0 (2023-06-27)¶

Feature¶

Drop support for Python 3.7 (#758) (d80f1e7)

Breaking¶

Drop support for Python 3.7 as it reached EOL on June 27, 2023. More infos: https://devguide.python.org/versions/ (d80f1e7)

v5.12.0 (2023-05-11)¶

Feature¶

Add User.create_playlist method (c768a8b)
Add User.remove_playlist method (289f021)
Add User.add_playlist method (7ec9bc9)
Add User.unfollow method (59b9329)
Add User.follow method (949918a)
Add User.remove_artist method (70825bf)
Add User.add_artist method (3ad512b)
Add User.remove_Track method (ccc7b76)
Add User.add_track method (1d9d3d2)
Add User.remove_album method (103c58b)
Add User.add_album method (013adde)

v5.11.1 (2023-05-10)¶

Fix¶

Rename argument for Playlist.reorder_tracks back to order to match parameter name from REST API (ea469e9)

v5.11.0 (2023-05-09)¶

Feature¶

Add ability to remove a bookmark on an episode (4eb896a)
Add ability to add a bookmark to an episode (6dc32ac)
Add ability to mark a playlist as seen (dac1530)

v5.10.0 (2023-05-08)¶

Feature¶

playlists: Add functions to create, edit, reorder and delete playlists and edit user library playlists (#709) (5257988)

v5.9.0 (2023-04-13)¶

Feature¶

search: Add search function for playlists (318d524)
recommendations: Add flow and recommendation functions (a03ac81)

Documentation¶

Add Un10ck3d as a contributor for code, doc, and test (#693) (0371bc4)
Move docs in a single folder (#634) (bb7b3d1)
Improve links between docs and source code (#632) (7258900)

v5.8.1 (2022-12-02)¶

Fix¶

Add Twitter and Mastodon links to PyPI (#631) (1a57b64)

v5.8.0 (2022-11-20)¶

Feature¶

Officially support Python 3.11 (#617) (f737d5b)

v5.7.0 (2022-11-11)¶

Feature¶

Manage user’s friends (#610) (6e116f5)

v5.6.0 (2022-09-06)¶

Feature¶

Show a content preview of the paginated list in the CLI (#568) (283d190)

Documentation¶

Fix links to resources and pagination classes (#567) (1adce18)
Fix errors in search usage documentation (#566) (d5c2e84)

v5.5.0 (2022-07-26)¶

Feature¶

Infer episode link & share from ID when missing (#544) (f38a038)

v5.4.0 (2022-07-25)¶

Feature¶

Fetch resource if accessing missing field on simplified instance (#541) (df5e81b)

v5.3.3 (2022-06-06)¶

Fix¶

deps: Revert PSR upgrade (f5119fc)

v5.3.2 (2022-04-28)¶

Fix¶

Remove rate album methods (3000fa7)

v5.3.1 (2022-04-23)¶

Fix¶

Add a few missing classes to top level API (98ef1a1)

Documentation¶

Reference each class from the top level (042ee17)

v5.3.0 (2022-04-23)¶

Feature¶

Get charts for a specified genre ID (dad1d94)

v5.2.0 (2022-02-09)¶

Feature¶

Get the top podcasts (f8f3438)
Get all podcasts for a genre (8f220fd)
Get a list of artist’s playlists (bd0f5ee)

v5.1.1 (2022-02-07)¶

Fix¶

Make Client.list_radios return a list (cfb3f98)
Make Client.list_genres return a list (ca83963)

Documentation¶

Complete Client.get_user_albums return type (46846dc)

v5.1.0 (2022-02-02)¶

Feature¶

Add Editorial resource (b98888e)

Documentation¶

Update contributions for prndrbr (eae4bfb)

v5.0.1 (2022-01-28)¶

Fix¶

Genre methods return a list (2c15056)

Documentation¶

Fix type hints and add documentation (beeacc4)
Fix a few urls in README.md (c12120b)
Add prndrbr as a contributor for doc (#442) (4387822)
Fix a few typos (69755f2)
Update contributing guide (a673690)
Update contributing guide (ca60f3c)
Fix outdated installation instruction (1129210)

v5.0.0 (2022-01-17)¶

Feature¶

Add PaginationList to improve how we deal with pagination (#425) (6a4ccf2)
Remove the tornado-based AsyncClient (#427) (96df7b8)

Breaking¶

support for Python 3.6 is dropped (6562a4c)
paginated responses are now managed via a PaginatedList wrapper class. As a result, the iter_... methods have been removed from all resources and merged into the corresponding get_... method. Search result also make use of these new paginated responses. (6a4ccf2)
the AsyncClient, based on Tornado, has been removed. If you still need it, stay on earlier version or vendor it into your codebase. (96df7b8)

Documentation¶

Show resources attributes and their type (383ffa3)
Split documentation for resources into multiple pages (4e96f75)
Fix mention of as_dict() method (0bfb849)
Fix a few typos and reformat files (91b8f5c)
Reword section about authentication (1e7b9e3)

v4.3.0 (2022-01-03)¶

Feature¶

Parse track contributors (719e42a)
Parse album contributors (bd02ec4)

v4.2.1 (2021-12-11)¶

Fix¶

deps: Update dependency myst-parser to ^0.16 (2fe0e71)

v4.2.0 (2021-12-07)¶

Feature¶

Deserialize date in Resource.as_dict() method (#399) (6337967)

Fix¶

Follow Deezer’s format when deserializing datetime (#411) (3be65e4)

Documentation¶

Add bjacquin as a contributor for code (#410) (138d317)

v4.1.0 (2021-10-20)¶

Feature¶

Add all documented fields to resources and type annotate them (9b093b2)
Add support for getting the current user (5e9b56e)

v4.0.0 (2021-10-17)¶

Feature¶

Port Client’s request method to AsyncClient (bd9edb2)
Refactor existing methods to use newer request (0ddc5c2)

Fix¶

Remove Comment resource as it’s no longer in the Deezer API (6bb0647)
Make Resource.get_relation work with Tornado client (0980055)

Breaking¶

the advanced_search method no longer exists and has been merged into the regular search method. (46cf5f1)
The get_object, object_url and url methods have been removed from the Client and AsyncClient classes (3b7c167)
The Client.get_radios method has been removed and replaced by Client.list_radios (b7d940f)
The Client.get_genres method has been removed and replaced by Client.list_genres (2e284af)
A DeezerErrorResponse is now raised in case of error, instead of ValueError (0ddc5c2)

v3.2.0 (2021-10-15)¶

Feature¶

Get current user’s listening history (43ea8ca)

Documentation¶

Update contributing guide with recent simplifications (0181cda)
Add Carababusha as a contributor for code (#390) (257a48f)
Update contributing guide to avoid leaking API tokens (784146e)

v3.1.0 (2021-10-09)¶

Feature¶

Ability to manage tracks from the user’s library (59b0f57)
Ability to manage artists from the user’s library (10f2967)
Ability to manage albums from the user’s library (45f9bba)
Add support to rate an album (c8dc771)
Add support to rate an album (1c72557)
Basic structure to support POST method (9da4e81)

v3.0.0 (2021-10-09)¶

Breaking¶

remove deprecated asdict method on Resource class (daeee61)
remove deprecated host and use_ssl arguments for Client (2bd2c39)

Documentation¶

Use https in link (f7eb114)

v2.4.0 (2021-10-07)¶

Feature¶

Add official python 3.10 support (b29b0cb)

v2.3.1 (2021-09-13)¶

Fix¶

deps: Update dependency sphinx-rtd-theme to v1 (af43757)

Documentation¶

Fix docstrings (0e87749)

v2.3.0 (2021-06-27)¶

Feature¶

Deprecate the asdict method from the Resource class (412b954)

v2.2.4 (2021-06-13)¶

Fix¶

deps: Update dependency myst-parser to ^0.15 (81ed3d8)

v2.2.3 (2021-05-04)¶

Fix¶

deps: Update dependency myst-parser to ^0.14 (9fbc55a)

v2.2.2 (2021-04-06)¶

Fix¶

Release in a separate environment (4d987d0)
deps: Update dependency sphinx-autobuild to v2021 (f70a1bd)
deps: Update dependency myst-parser to ^0.13 (73255fb)

v2.2.1 (2020-10-23)¶

Fix¶

Set minimum python version to 3.6 (4ff223d)
Poetry extras (cc36e0f)

v2.2.0 (2020-10-13)¶

Feature¶

Switch to Poetry (#196) (92030dd)

Fix¶

Build command for PSR (c76b8ea)

v2.1.0 (2020-10-10)¶

Feature¶

Add support for python 3.9 (b4669ee)

Documentation¶

Add naveen521kk as a contributor (#171) (0df16d3)

v2.0.0 (2020-10-01)¶

Feature¶

Drop support for Python 3.5 (20d999b)

Fix¶

Include docs/*.md files in package (5fcc38d)

Breaking¶

dropping EOL Python version (20d999b)

v1.6.2 (2020-09-21)¶

Fix¶

Remove universal wheel option (5f31f14)
Fix missing requirements when running tests (cb7d421)
Fix configuration for python-semantic-release (dd446d2)

v1.6.1 (2020-08-27)¶

🐛 Bug Fixes:¶

Fix Playlist.iter_fans, improve tests to catch similar errors #139 (hithomasmorelli)

v1.6.0 (2020-08-20)¶

🚀 Enhancements:¶

Fix crash for unknown resource, add Podcast & Episode resources #134 (hithomasmorelli)
📦 Move package metadata to setup.cfg #91 (browniebroke)

📖 Documentation updates:¶

Add hithomasmorelli as a contributor #138 (allcontributors[bot])

✅ Testing:¶

Use codecov-action to upload coverage report #97 (browniebroke)
Pin dependencies in requirements files #94 (browniebroke)
☂️ Increase test coverage to 100% #92 (browniebroke)

v1.5.0 (2020-07-01)¶

🚀 Enhancements:¶

Add get\_tracks and get\_fans methods to Playlist resources #90 (browniebroke)

📖 Documentation updates:¶

Migrate most of the docs to Markdown with MyST #85 (browniebroke)
Improve documentation for resources #84 (browniebroke)

✅ Testing:¶

Refactor tests to use the pytest style #89 (browniebroke)
Split resources tests into multiple classes #88 (browniebroke)
🛠 Move CI to Github actions #86 (browniebroke)

v1.4.0 (2020-05-02)¶

🚀 Enhancements:¶

Use explicit kwargs for the Client class #79 (browniebroke)

📖 Documentation updates:¶

Documentation reworking and explain usage #78 (browniebroke)
Auto generate changelog #75 (browniebroke)

✅ Testing:¶

Clean-up config for coverage #80 (browniebroke)
Use Python 3.8 on Travis (drop the -dev) #77 (browniebroke)
Update names in Github action & run on Python 3.8 #76 (browniebroke)

v1.3.0 (2019-11-09)¶

🚀 Enhancements:¶

Add Python 3.8 support #71 (jnth)

🐛 Bug Fixes:¶

Get method error handling #64 (nrebena)

✅ Testing:¶

Add isort #72 (browniebroke)
Remove appveyor.yml #70 (browniebroke)
Move deploy step to a separate stage on Travis #61 (browniebroke)

v1.2.0 (2019-09-25)¶

🚀 Enhancements:¶

Add a header kwarg in Client to force session headers #60 (jnth)
Add user’s favorite albums, artists, tracks and playlists in user resource. #53 (jnth)

📖 Documentation updates:¶

Update Travis CI badge: travis.org -> travis.com #57 (browniebroke)
Create .config for all-contributors bot #51 (browniebroke)

✅ Testing:¶

Create pythonpackage.yml to enable GitHub actions #58 (browniebroke)

v1.1.0 (2019-05-25)¶

💥 Breaking Changes:¶

Drop support for EOL Python 3.4 #47 (hugovk)

📖 Documentation updates:¶

Update template to match filename #48 (hugovk)

✅ Testing:¶

Python 3.7+ support #44 (browniebroke)
Test with vcrpy #43 (jnth)

v1.0.0 (2019-02-11)¶

💥 Breaking Changes:¶

Drop Python 2 support #41 (hugovk)

v0.9.0 (2019-02-10)¶

🚀 Enhancements:¶

Add advanced search method #37 (jnth)

v0.8.0 (2018-10-30)¶

🚀 Enhancements:¶

Auto-format code using black #35 (browniebroke)
Make tornado an optional requirements #34 (browniebroke)
Pagination feature #32 (MDCEY)

v0.7.0 (2018-10-03)¶

💥 Breaking Changes:¶

Change name files names and docs from async #28 (horstmannmat)

🚀 Enhancements:¶

Store the session in the client #24 (sheregeda)

✅ Testing:¶

Add a CI step for check-manifest #30 (browniebroke)
Update build matrices #29 (browniebroke)
Appveyor tests #25 (browniebroke)

v0.6.1 (2017-06-19)¶

🚀 Enhancements:¶

Add access token to request kwargs #20 (sheregeda)

📖 Documentation updates:¶

Update README.rst #18 (khamaileon)

v0.6.0 (2016-12-27)¶

🚀 Enhancements:¶

Refactoring: replace urlopen by requests #16 (browniebroke)

v0.5.0 (2016-12-26)¶

📖 Documentation updates:¶

Docs enhancements #13 (browniebroke)

✅ Testing:¶

Run Flake8 on Travis #14 (browniebroke)
Use tox-travis to integrate environments better #12 (browniebroke)

v0.4.0 (2016-12-08)¶

🚀 Enhancements:¶

Improve chart integration #11 (pfouque)
Add pypy to the build matrix #10 (browniebroke)
Implement chart methods #8 (pfouque)

✅ Testing:¶

Switch from coveralls to codecov #9 (browniebroke)
Correct a couple of flake8 warning #7 (browniebroke)
Add basic flake8 config to setup.cfg #6 (browniebroke)

v0.3.0 (2016-11-09)¶

🚀 Enhancements:¶

add resource parameters and iterators #5 (pfouque)
Async client for Tornado, search #1 (misuzu)

v0.2.1 (2015-09-14)¶

🚀 Enhancements:¶

Run tests against Python 3.5 #3 (browniebroke)

v0.2 (2015-01-31)¶

🚀 Enhancements:¶

Methods for resources #2 (misuzu)

v0.1 (2014-11-23)¶

* This Changelog was automatically generated by github_changelog_generator