Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Pure Python Spotify Web API wrapper library

Project description


Pure Python wrapper library for Spotify Web API.


pip install simple-spotify

Quick Start

from simple_spotify.api import Spotify
from simple_spotify.authorization import ClientCredentialsFlow

res = ClientCredentialsFlow.token_request(

auth = ClientCredentialsFlow(**res)
sp = Spotify(auth)

result ='sora tob sakana')

for album in result.albums.items:
sora tob sakana
cocoon ep
yozora wo zenbu
mahou no kotoba

If you execute endpoint which need AutotizationCodeFlow on your local envirnoment tempolary, authcode-fetch will be help you.

$ authcode-fetch

        Authorization Code Flow Support Tool

    Fetch authorization code from
    Output json file named simple-spotify_code.json.
    This json file includes client_id, client_secret, authorization code, redirect uri.
    Format of json file as follows.
        'client_id': client_id,
        'client_secret': client_secret,
        'code': authorization code,
        'redirect_uri': redirect_uri

Enter the your Client ID : YOUR CLIENT ID
Enter the your Client Secret : YOUR CLIENT SECRET
Enter the redirect URI :
Enter the scopes
Scope :user-read-birthdate
Add more scope ?(y/n) :n
# Open your default browser. Log in, authorize access
Enter the redirected URL : REDIRECTED URL

Then, simple-spotify_code.json generate on your current directory.

import json

from simple_spotify.api import Spotify
from simple_spotify.authorization import AuthorizationCodeFlow

with open('simple-spotify_code.json') as f:
    auth_dict = json.load(f)

res = AuthorizationCodeFlow.token_request(**auth_dict)
auth = AuthorizationCodeFlow(**res)
sp = Spotify(auth)

current_user = sp.get_current_user_profile()


  • v.0.1.0 (May 09, 2019): Initial release:

  • v.0.1.1 (May 10, 2019): Create sample web app, fix

  • v.0.1.2 (May 10, 2019): Upload to PyPI

  • v.0.1.3 (May 11, 2019): Bugfix on simple_spotify.api

  • v.0.1.4 (May 17, 2019): Added keyword argument market to following methods. get_album , get_albums, get_track, get_tracks

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 simple-spotify, version 0.1.4
Filename, size File type Python version Upload date Hashes
Filename, size simple_spotify-0.1.4.tar.gz (15.2 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