A light weight Python library for the Spotify Web API
Go to file
2020-02-16 12:37:52 +00:00
.github/workflows Add query doc link, closes #268 2020-02-02 16:04:44 +00:00
docs Add missing auth to doc examples, fixes #427 2020-01-21 23:34:50 +00:00
examples Fix 2020-02-12 23:14:26 +00:00
spotipy Fix exception is raised in exception handler, fixes #403 2020-02-16 12:37:52 +00:00
tests Add requests_timeout parameter to auth module (#233) 2020-02-13 00:04:40 +00:00
.gitignore Clean up + missing tests 2020-01-11 23:30:57 +00:00
CHANGELOG.md Bump to 2.9.0 2020-02-15 19:48:21 +00:00
LICENSE.md Bump to 2.6.0 2020-01-12 14:42:52 +00:00
MANIFEST.in Packaging tweaks 2014-06-16 13:39:32 -04:00
README.md Bump to 2.9.0 2020-02-15 19:48:21 +00:00
requirements.txt Bump requests from 2.3.0 to 2.20.0 (#400) 2020-01-15 10:36:55 +00:00
setup.py Bump to 2.9.0 2020-02-15 19:48:21 +00:00
tox.ini Linting of core subpackage + clean up imports (#437) 2020-02-09 12:59:20 +00:00

Spotipy

A light weight Python library for the Spotify Web API

Tests Documentation Status

Documentation

Spotipy's full documentation is online at Spotipy Documentation.

Installation

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 https://developers.spotify.com/. 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 = sp.search(q='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.