# YouTube Playlist Items API (https://www.socialcrawl.dev/platforms/youtube/playlist-items)

> Returns the videos in a YouTube playlist in order — video id, title, thumbnail, owning channel, and publish time — plus a `cursor` when more results are available. Pass `playlist_id` for the first page; forward `cursor` for subsequent pages.

TL;DR: `GET /v1/youtube/playlist/items` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `playlist_id` | yes | YouTube playlist id (the value after `list=` in a playlist URL). |
| `cursor` | no | Pagination cursor from a previous response — fetches the next page. |
| `channel_id` | no | YouTube channel id — pages that channel's uploads instead of a playlist. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/youtube/playlist/items?playlist_id=PLFgquLnL59alCl_2TQvOiD5Vgm1hCaGSI" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I list the videos in a YouTube playlist?

Send a GET to /v1/youtube/playlist/items with a playlist_id. The response returns the playlist's videos in order with video ID, title, thumbnail, owning channel, and publish time.

### Where do I find the playlist ID?

It is the value after list= in a playlist URL. Pass it as playlist_id on the first request to start paging through the playlist.

### How do I page through a long playlist?

Each response includes a cursor when more results exist. Forward it as cursor=... on the next request and repeat until the cursor is empty.

### Can I page a channel's uploads instead of a playlist?

Yes. Pass channel_id instead of playlist_id and the endpoint pages that channel's uploads feed using the same response shape.

### How much does the playlist items endpoint cost?

It is a standard endpoint at 1 credit per request, and new accounts start with 100 free credits to test it.

See the full YouTube API: https://www.socialcrawl.dev/platforms/youtube

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to list all videos in a YouTube playlist via API
- YouTube playlist items API without Data API quota