Skip to main content

Python API for the browse feature of Spotify

Project description

Latest PyPI version Number of PyPI downloads Travis CI build status Test coverage

Python-Tunigo is a python package that allows for simple access to Tunigo’s API. This is an API for fetching featured playlists and new releases for Spotify. It supports featured playlists, top playlists, new album releases and playlists for a range of different genres.

Tunigo’s API is what the Spotify client uses to provide its Browse-feature.

Note that the API is not documented or officially released, so it may change at any time.


Debian/Ubuntu/Raspbian: Install the python-tunigo or the python3-tunigo package from

sudo apt-get install python-tunigo
sudo apt-get install python3-tunigo

Arch Linux: Install the python2-tunigo or the python-tunigo package from AUR, e.g.:

yaourt -S python2-tunigo
yaourt -S python-tunigo

Else: Install the tunigo package from PyPI:

pip install tunigo


import tunigo
tunigo = tunigo.Tunigo()
for playlist in tunigo.get_featured_playlists():

See the examples/ directory for further examples.


Python-Tunigo is licensed under the Apache License, Version 2.0.


v1.0.0 (2016-02-07)

  • Add support for specifying a proxy to use.
  • Don’t specify region in API call if not given. (Fixes: #2)
  • Add the new field Release.artist_uri.
  • Fix type of Release.created to be int all places.
  • Add tests for all classes.

v0.1.3 (2014-11-29)

  • Fix check for content-type so it doesn’t fail after a change in the API.

v0.1.2 (2014-08-03)

  • Fix that some genres were not listed by using the same query options as

v0.1.1 (2014-07-21)

  • Allow Genre- and SubGenre-objects as arguments to get_genre_playlists.
  • Allow a SubGenre to be created with main_genre as a string.
  • Add __repr__ and __str__ methods to classes.

v0.1.0 (2014-06-24)

  • Initial release.

Project details

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
tunigo-1.0.0.tar.gz (15.1 kB) Copy SHA256 hash SHA256 Source None Feb 7, 2016

Supported by

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