skip to navigation
skip to content

tunigo 1.0.0

Python API for the browse feature of Spotify

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.
File Type Py Version Uploaded on Size
tunigo-1.0.0.tar.gz (md5) Source 2016-02-07 14KB