Spotify Playlist API
A public playlist and everything on it, 50 items a page, from its Spotify id or share link.
GET /v1/spotify/playlist1 credit Failed requests are free
About this endpoint
GET /v1/spotify/playlist takes playlistId or a public url (https://open.spotify.com/playlist/…). A found playlist returns data.playlist with title, description, coverArtUrl, followers (saves), itemCount and owner, and data.items in playlist order, up to 50 a page. itemCount is Spotify's own total and counts items it withholds as restricted, which data.items leaves out. Playlists can hold podcast episodes as well as songs, so each item has a type of track or episode: tracks carry artists, album and playCount; episodes carry their podcast.
Pass page.nextCursor as cursor, with the same playlist, to get the next page. An id that does not resolve answers lookupStatus: not_found.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Spotify Playlist API FAQ
How do I get a Spotify playlist's tracks through an API?
Call GET /v1/spotify/playlist with your Social Fetch API key (x-api-key) and playlistId or a public open.spotify.com/playlist/… url. Read data.playlist and data.items, then follow page.nextCursor.
How much does the Spotify Playlist API cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.
Can I read private playlists or my own library?
No. Only public playlists resolve. Private playlists and your own library need Spotify's official Web API with your account's permission.
Why do some items have no artists or play count?
They are podcast episodes (type: episode). Episodes have a podcast instead of artists and an album, and Spotify shows no play count for them.