Spotipy's full documentation is online at Spotipy Documentation.
pip install spotipyor upgrade
pip install spotipy --upgradeA 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/.
To create an app on https://developers.spotify.com/ and obtain the Client ID and Client Secret.
- On the homepage, click on "Dashboard".
- Login or create a Spotify account.
- Click on "Create An App".
- Click on your created app.
- Copy the "Client ID" and "Client Secret".
Add your new ID and SECRET to your environment:
"""
Importing allows the user to use Spotipy API to obtain a token from a Spotify profile to be used within the code
By using Spotipy, a user is able to obtain the necessary authentication information from a Spotify account and create
an object to be stored into a variable.
"""
import spotipy
from spotipy.oauth2 import SpotifyClientCredentials
"""
Without user authentication, the program immediately displays the information the program asks Spotify to provide.
client_id and client_secret are the only information needed to access a Spotify account. Below Spotipy will obtain a token
to authenticate and create an object the user can use.
"""
sp = spotipy.Spotify(auth_manager=SpotifyClientCredentials(client_id="YOUR_APP_CLIENT_ID",
client_secret="YOUR_APP_CLIENT_SECRET"))
"""
With the created object, now we can use Spotipy objects such as
the "search" function in order to find specific artists like weezer
It stores the information found into the results variable
"""
results = sp.search(q='weezer', limit=20)
# This is a loop going through each song created by weezer stored in the result variable
for idx, track in enumerate(results['tracks']['items']):
# Each loop the program will print a song name made by weezer
print(idx, track['name'])"""
These are libraries that will assist in the authentication process for the program and Spotify
It allows the user to use Spotipy API in order to obtain a token from the Spotify profile and be used within the code
"""
import spotipy
from spotipy.oauth2 import SpotifyOAuth
"""
With Spotipy, A user is able to obtain the necessary authentication information from Spotify and create an object
that gives user access to Spotipy's functions. With user authentication, the program will redirect the user to a separate website
and request the user to input the website web address to verify the user before printing the data. Scope determines
how much of the data the program can access.
"""
sp = spotipy.Spotify(auth_manager=SpotifyOAuth(client_id="YOUR_APP_CLIENT_ID",
client_secret="YOUR_APP_CLIENT_SECRET",
redirect_uri="YOUR_APP_REDIRECT_URI",
scope="user-library-read"))
"""
With the created object, now we can use the Spotipy functions such as the "current_user_saved_tracks()" in order to get all
the song information found in the Liked Song list of the Spotify account. The result will hold all the data gathered from the Liked Songs list
"""
results = sp.current_user_saved_tracks()
"""
After authentication, the user is able to use the object
to get specific information from the results, this program will use a loop to go through each item found.
"""
# This is a loop, going through each song in the Liked Song list
for idx, item in enumerate(results['items']):
# In each loop we a single track within the Liked Song list
track = item['track']
# With the specific track found, this will find the name of the track and the artist
print(idx, track['artists'][0]['name'], " – ", track['name']) For common questions please check our FAQ.
You can ask questions about Spotipy on Stack Overflow. Don’t forget to add the Spotipy tag, and any other relevant tags as well, before posting.
If you have suggestions, bugs or other issues specific to this library, file them here. Or just send a pull request.