/spotipy

A light weight Python library for the Spotify Web API

Primary LanguagePythonMIT LicenseMIT

Spotipy

A light weight Python library for the Spotify Web API

Documentation Status

Documentation

Spotipy's full documentation is online at Spotipy Documentation.

Installation

If you already have Python on your system you can install the library simply by downloading the distribution, unpack it and install in the usual fashion:

python setup.py install

You can also install it using a popular package manager with

pip install spotipy

or

easy_install spotipy

Dependencies

  • Requests - spotipy requires the requests package to be installed

Quick Start

A full set of examples can be found in the online documentation and in the Spotipy examples directory. Here are two basic examples.

To get started, install spotipy and create an app on https://developers.spotify.com/. Add your new ID and SECRET to your environment:

export SPOTIPY_CLIENT_ID='your-spotify-client-id' export SPOTIPY_CLIENT_SECRET='your-spotify-client-secret'

Then, create a Spotify object and call methods:

import spotipy
from spotipy.oauth2 import SpotifyClientCredentials

sp = spotipy.Spotify(client_credentials_manager=SpotifyClientCredentials())

results = sp.search(q='weezer', limit=20)
for i, t in enumerate(results['tracks']['items']):
    print(' ', i, t['name'])

Reporting Issues

If you have suggestions, bugs or other issues specific to this library, file them here. Or just send me a pull request.