Spotipy's full documentation is online at Spotipy Documentation.
pip install spotipy
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 idx, track in enumerate(results['tracks']['items']):
print(idx, track['name'])
If you have suggestions, bugs or other issues specific to this library, file them here. Or just send me a pull request.