Using the Spotify Web API in a Python application


Spotify provides different ways to authenticated and/or authorize users in order to access resources on their accounts. In this tutorial, we will look at the Authorization Code Flow method.

NB: This method is NOT suitable for public clients(i.e. Client-side Javascript or single page applications). Only use this for server applications which are not exposed to the public

  • Here is a full working example on github

i. Step 1 - Create a flask application running on localhost

import os

import flask
import requests

HOST_PORT = 9000

# Create a flask application
app = flask.Flask('YOUR_APP_NAME')

# Create a default route
def index():
    return 'It works!'

$ This route will redirect the user to the spotify login page

$ Once the user is authenticated, spotify will send an Authorization Code to the specified REDIRECT_URI

$ NB: Make sure to specify the required SCOPES for the services you intend to use

$ Reference:
def login():
    authentication_request_params = {
        'response_type': 'code',
        'client_id': os.getenv('CLIENT_ID'),
        'redirect_uri': os.getenv('REDIRECT_URI'),
        'scope': 'user-read-email user-read-private user-top-read',
        'state': str(uuid.uuid4()),
        'show_dialog': 'true'

    auth_url = '' + urllib.urlencode(authentication_request_params)

    # Opens the spotify login page using the default browser

if __name__ == '__main__':, HOST_PORT)

ii. Step 2 - Add an authorization callback handler

# .....

def _get_access_token(authorization_code:str):
    spotify_request_access_token_url = ''
    body = {'grant_type': 'authorization_code',
            'code': authorization_code,
            'client_id': os.getenv('CLIENT_ID'), 
            'client_secret': os.getenv('CLIENT_SECRET'),
            'redirect_uri': os.getenv('REDIRECT_URI')
    response: requests.Response =, data=body)
    if response.status_code == 200:
        return response.json()

    raise Exception(f'Failed to obtain Access token.Response: {response.text}')

"""Callback route

$ This is the url that the user will be REDIRECTED to after the spotify login screen

$ The URL must match the REDIRECT_URL setting on your spotify developer dashboard

$ Spotify will send back a code which is then used to request an access token through a 'back-chanel'
def callback():

    code = flask.request.args.get('code')
    credentials = _get_access_token(authorization_code=code)

    os.environ['token'] = credentials['access_token']

    return f"Authentication successful. Access token: {credentials['access_token']}"

# ....

Step 3 - Test the API (Get Current User’s top tracks)

# ....
 def top_tracks():
    root_url = '{tracks}'

    # NB: Add the access token to the request header
    headers = {
        'Authorization': f'Bearer {os.getenv("token")}'
    request_params = {
            'time_range': 'medium_term',
            'limit': 20,
            'offset': 0

    # NOTE: This requires the scope 'user-top-read'
    full_url = root_url + urllib.urlencode(request_params)
    response = requests.get(full_url,

    if response.status_code == 200:
        return response.json()
    raise Exception(f'API Call to {full_url} failed. {response.text}')
# .....


  • Here is a full working example on github
  • Suggested improvements:

    • Verify the state value on the authentication callback handler
    • Add a token refresh handler
    • Check if token is expired before making a request
    • etc.

Further reading

Written by@NdamuleloNemakh
Welcome to my coding diary, I hope you find it useful!