Skip to content
spotify-effect ← opensound

spotify-effect

A fully typed, Effect-native Spotify Web API client. Composable services, structured errors, and built-in pagination — all powered by Effect.
Get Started API Reference

Effect-native

Every API call returns an Effect, giving you structured concurrency, dependency injection, and typed error handling out of the box.

Three packages

@spotify-effect/core for Node.js, @spotify-effect/browser for PKCE flows, and @spotify-effect/otel-node for OpenTelemetry tracing.

39+ endpoints

Full coverage of Albums, Artists, Browse, Follow, Library, Markets, Personalization, Player, Playlists, Search, Tracks, and Users.

Typed errors

Discriminated union errors — SpotifyHttpError, SpotifyRateLimitError, SpotifyParseError — with automatic retry classification.