Registry / http-networking / spotifywebapipython

spotifywebapipython

library1.0.270pypypi✓ verified 83d ago

A modern, typed Python3 library for the Spotify Web API, supporting OAuth, pagination, and all major endpoints. Current version 1.0.270, released on PyPI with active development.

http-networking auth-security

pip install spotifywebapipython

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · SPOTIFYWEBAPIPYTHO

spotifywebapipython

http-networkingpythonv1.0.270

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

SpotifyClient

✓ from spotifywebapipython import SpotifyClient

Main client class.

SpotifyError

✓ from spotifywebapipython import SpotifyError

Base exception class.

Initialize client, authenticate, and search for a track.

from spotifywebapipython import SpotifyClient client = SpotifyClient( client_id=os.environ.get('SPOTIFY_CLIENT_ID', ''), client_secret=os.environ.get('SPOTIFY_CLIENT_SECRET', ''), redirect_uri=os.environ.get('SPOTIFY_REDIRECT_URI', '') ) # Authenticate (requires user interaction for authorization code flow) # For simplicity, use client credentials flow (no user-specific data): client.authenticate() # Search for a track results = client.search('Never Gonna Give You Up', type='track') print(results)

Debug

Known issues

breakingIn version 1.0.0, the authentication flow changed from implicit grant to authorization code flow. The old `SpotifyClient(access_token=...)` pattern no longer works.

fix

Use `SpotifyClient(client_id, client_secret, redirect_uri)` and call `authenticate()`.

affects: <1.0.0

deprecatedThe `SpotifyClient.playlist()` method is deprecated in favor of `SpotifyClient.get_playlist()` as of v1.0.100. It will be removed in v2.0.0.

fix

Replace `client.playlist(id)` with `client.get_playlist(id)`.

affects: >=1.0.100

gotchaWhen using the authorization code flow, the `redirect_uri` must exactly match the one registered in the Spotify Developer Dashboard, including trailing slashes.

fix

Use the exact URI string, e.g., 'http://localhost:8888/callback'.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'spotifywebapipython'

Library not installed or installed in wrong environment.

fix

Run `pip install spotifywebapipython` in the correct Python environment (e.g., venv).

TypeError: __init__() missing 3 required positional arguments: 'client_id', 'client_secret', 'redirect_uri'

Using old instantiation pattern from version <1.0.0.

fix

Update code to `SpotifyClient(client_id, client_secret, redirect_uri)`.

spotifywebapipython.exceptions.SpotifyError: 401 - Unauthorized

Invalid or expired access token; or missing scopes.

fix

Re-authenticate with proper scopes (e.g., `client.authenticate(scopes=['user-library-read'])`).

Upgrade

Version history

1.0.270latest on PyPI · released Apr 21, 2026

Audit

Dependencies

httpxrequiredHTTP client for API requests

pydanticrequiredData validation and settings management

Agent activity

26 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/thlucas1/spotifywebapiPython ↗

packagehttps://pypi.org/project/spotifywebapipython/ ↗

docshttps://spotifywebapiPython.readthedocs.io/en/latest/__init__.html ↗

changeloghttps://github.com/thlucas1/spotifywebapiPython/blob/master/CHANGELOG.md ↗