# zmb3/spotify

A Go wrapper for the Spotify Web API

Repository: https://github.com/zmb3/spotify
Canonical: https://ross.abutalabs.com/products/spotify
Language: Go
License: Apache-2.0
License Family: permissive
Last push: 2026-07-02T12:02:54+00:00

## Health v2 (maintenance only)
Score: 63/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 90, release rhythm 8, longevity 100
- inputs: {"age_days": 4238, "days_push": 62, "days_rel": 660, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1574, forks 315 (observed 2026-08-28T04:05:05.808535+00:00)

## What it is
A Go client library wrapping the Spotify Web API, aiming to cover every endpoint in the API reference. It includes an Authenticator type handling OAuth2 authorization code and client credentials flows, plus automatic retry for rate-limited requests.

## Use cases
- control spotify playback from a go program
- fetch spotify playlists and tracks via api
- authenticate with spotify oauth2 in go
- search spotify catalog from my app
- build a music recommendation tool using spotify data

## When to choose
- you're writing a Go application that needs Spotify Web API access
- you want OAuth2 flow handling and rate-limit retries handled for you

## When to avoid
- you need Spotify Connect hardware control or local playback outside the Web API
- you're not using Go

## Facets
- artifact type: library
- maturity: active
- function: http-client, auth, sdk
- domain: apis, developer-tools, media
- platform: go, cross-platform
- tags: spotify, music, web-api, oauth2, api-wrapper

## Member repositories
- zmb3/spotify (main) score 63

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:05.808535+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-30T03:57:55.736337+00:00, confidence not recorded.
  - readme: https://github.com/zmb3/spotify (fetched 2026-08-28T04:05:05.808535+00:00, sha bab63890354e)
- Data as of 2026-08-30T08:39:29.467469+00:00.