> **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/youtube/channels-playlists>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/youtube/channels-playlists.mdx>

---

# YouTube Channel Playlists API

Every playlist on a channel's Playlists tab, with its title, cover and video count.

`GET /v1/youtube/channels/playlists` takes a `handle` or `channelId` and returns `data.playlists` in the order the channel shows them. Each playlist has `id`, `url`, `title`, `thumbnailUrl`, `videoCount` and `firstVideoId`; `data.channel` identifies the channel. Pass `data.page.nextCursor` as `cursor` while `data.page.hasMore` is `true`.

An unknown channel is `data.lookupStatus: not_found`. To read the videos in one playlist, pass its `id` to `GET /v1/youtube/playlists`.

## Request

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

## FAQ

### How do I list a YouTube channel's playlists via API?

Call GET /v1/youtube/channels/playlists with your Social Fetch API key (x-api-key) and a handle or channelId. Read data.playlists, and page with data.page.nextCursor.

### How much does the YouTube Channel Playlists 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.

### How do I get the videos inside a playlist?

Pass the playlist's id to GET /v1/youtube/playlists, which lists its videos page by page.

### Does it include playlists a channel hides?

No. It lists what the channel shows publicly on its Playlists tab. Private and unlisted playlists are not shown there.
