Skip to main content

A light weight Python library for the Spotify Web API

Project description


A light weight Python library for the Spotify Web API

Tests Documentation Status


Spotipy's full documentation is online at Spotipy Documentation.


pip install spotipy

Quick Start

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

To get started, install spotipy and create an app on Add your new ID and SECRET to your environment:

export SPOTIPY_CLIENT_ID=client_id_here
export SPOTIPY_CLIENT_SECRET=client_secret_here

// on Windows, use `SET` instead of `export`

Then, create a Spotify object and call methods:

import spotipy
from spotipy.oauth2 import SpotifyClientCredentials

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

results ='weezer', limit=20)
for idx, track in enumerate(results['tracks']['items']):
    print(idx, track['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.

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 spotipy, version 2.12.0
Filename, size File type Python version Upload date Hashes
Filename, size spotipy-2.12.0-py2-none-any.whl (18.9 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size spotipy-2.12.0-py3-none-any.whl (18.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size spotipy-2.12.0.tar.gz (20.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page