Skip to main content

Unofficial API for TIDAL music streaming service.

Project description

Unofficial Python API for TIDAL music streaming service.

0.7.0 Rewrite

Currently the project is being rewritten to make it easier to maintain and create documentation for, see for progress. There may be breaking changes, but i might be able to keep the current usage for a deprecation period. Anyways, you should probably wait with writing pull requests until 0.7.0 has been released.


Install from PyPI using pip:

$ pip install tidalapi

Example usage

import tidalapi

session = tidalapi.Session()
# Will run until you visit the printed url and link your account
tracks = session.get_album_tracks(album_id=16909093)
for track in tracks:


Documentation is available at https://0-6-x–



  • Support OAuth login through login_oauth_simple() and login_oauth() - morguldir
  • Support loading an OAuth session through load_oauth_session() - morguldir
  • Include more info when a request fails - morguldir


  • Fix wimp images not resolving - ktnrg45
  • Made the favorite playlists function also return created playlists - morguldir


  • Update api token and slightly obfuscate it - morguldir



  • Add parameter to search() allowing for more results (up to 300) - morguldir
  • Fix get_track_url() not returning anything - morguldir


  • Fix quality options using enum names instead of values - morguldir
  • Handle situations where tidal doesn’t set the version tag - morguldir


  • Update lossless token - morguldir
  • Always use the same api token - morguldir
  • Include additional info when logging fails - morguldir
  • Make user_id and country_code optional when using load_session() - morguldir
  • Add version tag for Track - Husky22
  • Switch to netlify for documentation - morguldir

Project details

Download files

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

Files for tidalapi, version 0.6.8
Filename, size File type Python version Upload date Hashes
Filename, size tidalapi-0.6.8-py2-none-any.whl (13.0 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size tidalapi-0.6.8-py3-none-any.whl (13.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size tidalapi-0.6.8.tar.gz (18.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page