> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/spotify/playlist>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/spotify/playlist.mdx>

---

# Spotify Playlist API

A public playlist and everything on it, 50 items a page, from its Spotify id or share link.

`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`.

## Request

- **Endpoint:** `GET /v1/spotify/playlist`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by playlist id or URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/spotify/playlist/get)
- **Platform page:** [/platforms/spotify](https://www.socialfetch.dev/platforms/spotify)

## 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.
