# spotipy-dev/spotipy

A light weight Python library for the Spotify Web API

Repository: https://github.com/spotipy-dev/spotipy
Canonical: https://ross.abutalabs.com/products/spotipy
Homepage: http://spotipy.readthedocs.org
Language: Python
License: MIT
License Family: permissive
Last push: 2026-06-29T12:22:52+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 90, release rhythm 49, longevity 100
- inputs: {"age_days": 4533, "days_push": 65, "days_rel": 183, "gap_med": 96, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5468, forks 970 (observed 2026-08-28T04:09:19.596645+00:00)

## What it is
Spotipy is a lightweight Python client library for the Spotify Web API, providing access to all Spotify endpoints including music search, track/album/artist data, and user library management. It includes built-in OAuth2 authorization flows for both client-credentials and user-authenticated access.

## Use cases
- search spotify tracks and artists from python
- get a user's saved spotify playlists and library
- build a music recommendation script using spotify data
- authenticate with spotify oauth in a python app
- fetch audio features and metadata for tracks
- automate playlist creation via the spotify api

## When to choose
- you need Python access to the full Spotify Web API with minimal setup
- you want ready-made OAuth2 authorization flows for Spotify
- you need a well-documented, widely used Spotify client

## When to avoid
- you need access to a music service other than Spotify
- you want a non-Python client or a lower-level raw HTTP wrapper
- you need features of Spotify's private or undocumented APIs

## Facets
- artifact type: library
- maturity: active
- function: http-client, auth, sdk
- domain: apis, audio, developer-tools, web-development
- platform: python, cross-platform
- tags: spotify, music-api, oauth, api-client, rest-client

## Member repositories
- spotipy-dev/spotipy (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:19.596645+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:56:45.105904+00:00, confidence not recorded.
  - readme: https://github.com/spotipy-dev/spotipy (fetched 2026-08-28T04:09:19.596645+00:00, sha bcc3ab3d6c8e)
- Data as of 2026-08-30T08:39:29.467469+00:00.