# thelinmichael/spotify-web-api-node

A Node.js wrapper for Spotify's Web API.

Repository: https://github.com/thelinmichael/spotify-web-api-node
Canonical: https://ross.abutalabs.com/products/spotify-web-api-node
Homepage: http://thelinmichael.github.io/spotify-web-api-node/
Language: JavaScript
License: MIT
License Family: permissive
Archived: true
Last push: 2024-06-14T18:34:58+00:00

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

## Adoption (not part of the score)
Stars 3153, forks 491 (observed 2026-08-28T04:07:46.227716+00:00)

## What it is
A Node.js and browser client wrapper for Spotify's Web API, providing helper methods for tracks, albums, artists, playlists, user profiles, and playback. It handles OAuth authorization flows and returns promises for all API calls.

## Use cases
- fetch track and album metadata from Spotify
- create and manage user playlists programmatically
- authenticate users with Spotify OAuth
- search Spotify for artists, tracks, and playlists
- get audio features and recommendations for tracks
- control and inspect the user's Spotify playback

## When to choose
- building a Node.js or browser app that integrates with Spotify
- you want a promise-based client covering most Spotify Web API endpoints
- you need OAuth authorization code and client credentials flows handled for you

## When to avoid
- you need a wrapper for a music service other than Spotify
- the project is in maintenance mode and you need the newest Spotify API endpoints immediately
- you prefer writing raw HTTP requests with your own HTTP client

## Facets
- artifact type: library
- maturity: maintenance
- function: http-client, sdk, auth
- domain: apis, web-development, developer-tools, media
- platform: browser, cross-platform
- tags: spotify, music-api, api-wrapper, oauth, playlists, nodejs, javascript

## Member repositories
- thelinmichael/spotify-web-api-node (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:46.227716+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-30T07:25:40.915854+00:00, confidence not recorded.
  - readme: https://github.com/thelinmichael/spotify-web-api-node (fetched 2026-08-28T04:07:46.227716+00:00, sha 1ad7f45cea48)
  - homepage: http://thelinmichael.github.io/spotify-web-api-node/ (fetched 2026-08-29T09:40:29.414184+00:00, sha 5d3bdd3e158d)
  - registry_npm: https://registry.npmjs.org/spotify-web-api-node (fetched 2026-08-29T09:40:29.424412+00:00, sha 5284e773d0e4)
- Data as of 2026-08-30T08:39:29.467469+00:00.