A light weight Python library for the Spotify Web API
Go to file
Stephane Bruckert db65b98790 Bump to 2.8.0
2020-02-12 22:42:20 +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 Auto-refresh AuthCode flow token. (#435) 2020-02-10 10:20:02 +00:00
spotipy Fix integration tests 2020-02-12 22:27:42 +00:00
tests Prompt option to always show a dialog when giving permissions to Spotify (#438) 2020-02-12 20:49:26 +00:00
.gitignore Clean up + missing tests 2020-01-11 23:30:57 +00:00
CHANGELOG.md Bump to 2.8.0 2020-02-12 22:42:20 +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.8.0 2020-02-12 22:42:20 +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.8.0 2020-02-12 22:42:20 +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.