Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Python API for the browse feature of Spotify

Project Description

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.
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
tunigo-1.0.0.tar.gz (15.1 kB) Copy SHA256 Checksum SHA256 Source Feb 7, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting