Catalog

Playlists

Search the public playlist catalogue, generate a fresh playlist from any track, artist or album URI, then open one for its tracks, audio fingerprint and follower history.

Try

GET /search?type=playlists

Generate

Playlist from a seed

Paste a Spotify URI for a track, artist or album. The endpoint answers with the playlists Spotify builds around it — no OAuth, no recommendation model of our own.

GET /seed_to_playlist?uri=

Try

The Playlists endpoints

Full metadata, paginated track listings, aggregate audio analysis and follower history — one REST surface, no token refresh.

  • GET /playlist?id=Name, description, owner, follower count and cover art.
  • GET /playlist_tracks?id=&offset=&limit=Paginated tracks. The upstream page size tops out at 100.
  • GET /playlist_analysis?id=Aggregate audio features, decade spread and total running time.
  • GET /playlist_snapshot?id=Stored snapshots and the follower delta between them.
  • GET /seed_to_playlist?uri=Playlists generated around a track, artist or album URI.
  • GET /search?type=playlists&q=Keyword search across the public playlist catalogue.

What you can build

Curators & editorial teams

Track follower deltas across competitor playlists, surface trending entries, and benchmark daily growth.

Mood & activity apps

Generate playlists per mood from a single seed track. No model training, no cold start.

Fitness & wellness apps

Build BPM-matched workout playlists by combining /playlist_analysis tempo data with /seed_to_playlist.

Podcast & content directories

Index podcast-related playlists alongside episode metadata for better content discovery.

Playlist analytics SaaS

Sell dashboards to creators showing follower velocity, track turnover, and audio fingerprint trends.

Music school assignments

Auto-grade student-curated playlists against energy/valence/tempo targets via /playlist_analysis.

FAQ

Can I paginate through playlists with thousands of tracks?

Yes. /playlist_tracks accepts offset and limit parameters; the upstream maximum page size is 100. Loop until you've fetched the reported total.

How fresh is playlist follower data?

Metadata is pulled in real time from Spotify on each request. Snapshots store historical deltas for trend analysis.

Does seed_to_playlist need OAuth?

No. Pass a Spotify URI (track, artist, or album) and the endpoint returns the playlists Spotify generates around it, with no user-auth dance.

What audio features come back from /playlist_analysis?

Averages plus minimum and maximum for energy, danceability, valence, tempo, loudness, acousticness, instrumentalness, liveness and speechiness across every analysed track.

Can I build a clone of Spotify Wrapped with this?

Partially — for public playlists yes. Personal listening history requires Spotify Web API OAuth scopes which this proxy does not handle.

Get production access

Three ways to plug the Playlists endpoints into your stack — pick whichever fits your billing and infrastructure.