---
id: spotifywebapipython
version: "1.0.288"
license: unclear
license_treatment: permissive
maintenance: active
---

# spotifywebapipython — Spotify Web API Python3 Library

License: permissive · Maintenance: active · Downloads: 88.0K/mo

## What it is and what it does

spotifywebapipython is a Python 3 client library for the Spotify Web API that handles OAuth2 authorization flows (Authorization Code, Authorization Code PKCE, Client Credentials) with automatic token storage and renewal. It provides access to Spotify's full API surface—albums, artists, audiobooks, playlists, tracks, user profiles, search, and player control—plus support for Spotify Connect device management and playback control.

The library depends on requests, oauthlib, and requests-oauthlib for HTTP and authentication, plus lxml, pillow, and zeroconf for media handling and device discovery. It includes built-in caching for rarely-changed data like categories and genres, and integrates with smartinspectpython for optional structured logging. A Spotify account and registered app (for Client ID and Secret) are required to use it; some endpoints require a premium account.

Use it for:

- Build a Python application that searches Spotify's catalog and retrieves album, artist, or track metadata.
- Create a playlist manager that reads, modifies, and creates playlists programmatically on behalf of a user.
- Control Spotify playback on Connect devices (pause, resume, skip, volume) from a custom Python application.
- Fetch user profile data, top tracks, and listening history for analytics or personalization.
- Integrate Spotify recommendations and audio feature analysis into a music discovery or curation tool.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python library that wraps the Spotify Web API, enabling retrieval of music data and control of Spotify Connect playback devices through OAuth2 authentication.

Yes. The library is actively maintained, has low install friction, carries no known vulnerabilities, and is licensed permissively. It covers a comprehensive API surface and handles OAuth complexity internally. Install it if you need to build Spotify integrations in Python; verify that your use case doesn't require endpoints not yet exposed by the wrapper.

## Install

pip install spotifywebapipython
uv add spotifywebapipython
poetry add spotifywebapipython

## Installing spotifywebapipython

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release (4 days old) and an active repository. Requires Python 3.11.0 or greater.

License in practice: Licensed under MIT (permissive), allowing use in commercial and private projects with minimal restrictions.

Quickstart:

pip install spotifywebapipython

from spotifywebapipython.spotifyclient import SpotifyClient

client = SpotifyClient(client_id='YOUR_CLIENT_ID', client_secret='YOUR_CLIENT_SECRET')
results = client.search('track:Bohemian Rhapsody artist:Queen')

Requires Python 3.11.0 or greater. You must register a Spotify App to obtain a Client ID and Client Secret from the Spotify Developer Portal.

Verify before relying:

- Whether all Spotify Web API endpoints are fully covered or if some remain unimplemented.
- Performance characteristics when handling large playlists or frequent API calls.
- Rate-limiting behavior and how the library handles Spotify API throttling.
- Whether premium account features are clearly documented per endpoint.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 88.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

spotify api python client, spotify web api wrapper, spotify playback control python, spotify music data retrieval, spotify oauth authentication, spotify connect device control, spotify playlist management, spotify-integration, oauth-client, music-api

[View on SkillFed](https://skillfed.io/packages/spotifywebapipython) · [View on PyPI](https://pypi.org/project/spotifywebapipython/)