# JMPerez/spotify-web-api-js

A client-side JS wrapper for the Spotify Web API

Repository: https://github.com/JMPerez/spotify-web-api-js
Canonical: https://ross.abutalabs.com/products/spotify-web-api-js
Homepage: https://jmperezperez.com/spotify-web-api-js/
Language: TypeScript
License: MIT
License Family: permissive
Topics: spotify, wrapper, api, spotify-web-api, spotify-webapi, spotify-api, spotify-sdk, spotify-library
Last push: 2024-05-17T18:10:53+00:00

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

## Adoption (not part of the score)
Stars 1892, forks 265 (observed 2026-08-28T04:05:50.473653+00:00)

## What it is
A lightweight, dependency-free JavaScript/TypeScript wrapper for the Spotify Web API, covering all endpoints with helper methods that support both callbacks and promises. It is designed for browser use and ships as a small (~2.6kB gzipped) npm package.

## Use cases
- fetch spotify track and album metadata in a web app
- create and manage spotify playlists from the browser
- search spotify for artists tracks and podcasts
- get a user's top artists and recently played tracks
- control spotify playback like play pause and skip
- manage a user's saved tracks and shows library

## When to choose
- building a browser-based app that talks to the Spotify Web API
- you want a tiny, dependency-free client covering every Spotify endpoint
- you prefer promise- or callback-based requests without a heavy SDK

## When to avoid
- making Spotify API requests from Node.js (use spotify-web-api-node instead)
- you need OAuth token handling or a full framework with built-in auth flows
- the project is in maintenance mode and you need actively evolving features

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

## Member repositories
- JMPerez/spotify-web-api-js (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:50.473653+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:12:56.394156+00:00, confidence not recorded.
  - readme: https://github.com/JMPerez/spotify-web-api-js (fetched 2026-08-28T04:05:50.473653+00:00, sha 5889ba32e4a5)
  - homepage: https://jmperezperez.com/spotify-web-api-js/ (fetched 2026-08-29T10:52:14.856532+00:00, sha 7e59fe5c8160)
  - registry_npm: https://registry.npmjs.org/spotify-web-api-js (fetched 2026-08-29T10:52:14.866530+00:00, sha 8d4fc6ab40b9)
- Data as of 2026-08-30T08:39:29.467469+00:00.