Get Spotify playlist
Get a Spotify playlist and its tracks by id or playlist URL.
Headers
Get your API keyAPI key (`sfk_...`)
Spotify playlist id, such as `37i9dQZF1DX4UtSsGT1Sbe`. Pass this or `url`.
min 1 chars · max 128 chars
Public Spotify playlist URL, such as `https://open.spotify.com/playlist/37i9dQZF1DX4UtSsGT1Sbe`. Pass this or `playlistId`.
min 1 chars · max 4096 chars
Pass `page.nextCursor` from the previous response to get the next page.
min 1 chars · max 9 chars
Endpoint-specific response payload.
Whether the playlist was found.
one of: found, not_found
Playlist details when available.
Platform for this playlist.
one of: spotify
Stable Spotify playlist identifier.
min 1 chars
Playlist title.
min 1 chars
Playlist description as plain text when available.
Best available playlist cover image URL when available.
Canonical public Spotify playlist URL.
min 1 chars
Number of users who saved the playlist when available.
≥ 0
Total number of items (tracks and episodes) on the playlist when available, as Spotify reports it. It counts items Spotify withholds as restricted content, which `items` leaves out, so it can exceed the number of items returned across all pages.
≥ 0
Playlist owner when available.
Spotify user id of the owner.
min 1 chars
Owner display name when available.
Public Spotify profile URL of the owner.
min 1 chars
Tracks and episodes on this page in playlist order, up to 50.
Kind of item: a music track or a podcast episode.
one of: track, episode
Spotify track id, or episode id for an episode.
min 1 chars
Track or episode title.
min 1 chars
Canonical public Spotify track or episode URL.
min 1 chars
Duration in milliseconds when available.
≥ 0
Whether the item is marked explicit.
Whether the item is playable on Spotify when available.
Reported play count of a track when available; null for episodes.
≥ 0
Album a track belongs to when available; null for episodes.
Spotify album id. Pass it to the Spotify album endpoint for the full tracklist.
min 1 chars
Album title.
min 1 chars
Best available square cover image URL when available.
Artists credited on a track (empty for episodes).
Spotify artist id.
min 1 chars
Artist display name.
min 1 chars
Podcast an episode belongs to when available; null for tracks.
Spotify podcast id.
min 1 chars
Podcast title.
min 1 chars
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/spotify/playlist?playlistId=37i9dQZF1DX4UtSsGT1Sbe" \
-H "x-api-key: YOUR_API_KEY"Responses
Spotify playlist with a page of its tracks and episodes.