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

> Returns videos in a YouTube playlist including titles, view counts, durations, thumbnails, and channel info.

TL;DR: `GET /v1/youtube/playlist` 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 |
| `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?playlist_id=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get every video in a YouTube playlist?

Send a GET request to /v1/youtube/playlist with playlist_id=PL.... The response is a list of videos with title, view count, duration, thumbnail URL, and channel info for each entry.

### Where do I find a YouTube playlist ID?

It's the string after list= in any playlist URL (e.g. https://www.youtube.com/playlist?list=PL.... → PL...). SocialCrawl accepts that ID directly in the playlist_id parameter.

### What fields come back for each video in the playlist?

videoId, title, duration, viewCount, thumbnails, channel (id, title, handle), and position in the playlist. Ordering matches the playlist owner's chosen order.

### Does this work for 'Watch later' or private playlists?

Only for public and unlisted playlists the viewer can normally load without signing in. Private playlists and personal lists like Watch Later require OAuth, which SocialCrawl deliberately does not touch.

### How much does one playlist request cost?

1 credit per playlist request — a single call returns every video in the playlist (paginated where YouTube returns pages). 100 free credits on signup, no card required.

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 get all videos in a YouTube playlist via API
- SocialCrawl YouTube playlist API example