# YouTube Channel Videos API (https://www.socialcrawl.dev/platforms/youtube/channel-videos)

> Returns a list of recent videos published by a YouTube channel. Each video includes title, view count, like count, comment count, duration, thumbnail URL, and publish date.

TL;DR: `GET /v1/youtube/channel/videos` 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 |
| --- | --- | --- |
| `channelId` | no | YouTube channel ID |
| `handle` | no | YouTube channel handle without the @ symbol |
| `sort` | no | Sort by latest or popular (latest \| popular) |
| `continuationToken` | no | Continuation token to get more videos. Get 'continuationToken' from previous response. |
| `includeExtras` | no | This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. This will slow down the response slightly. |
| `is_paid_promotions` | no | Set to 'true' to search YouTube's public paid product placement / sponsorship / endorsement surface — returns normal videos where the creator disclosed a paid promotion. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/youtube/channel/videos" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I list all videos from a YouTube channel?

Send a GET request to /v1/youtube/channel/videos with a handle or channelId. Pass continuationToken from the response to page through every upload — no 500-video cap like the official API.

### Can I sort channel videos by latest or popular?

Yes. Pass sort=latest for reverse-chronological order, or sort=popular for the most-viewed videos. Default is latest if you omit the parameter.

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

videoId, title, viewCount, duration, thumbnail URL, and publishDate. Add includeExtras=true to also pull likeCount, commentCount, and the video description — at the cost of slightly slower responses.

### How do I paginate through every video?

The first response includes a continuationToken. Pass it back as continuationToken=... on the next request to get the next page, and repeat until the token is empty. Each page is one credit.

### Does this endpoint include Shorts?

Long-form videos only. Use /v1/youtube/channel/shorts to fetch the Shorts feed separately — the official site treats them as two distinct tabs, and SocialCrawl mirrors that split.

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 uploads from a YouTube channel without API quota
- What fields does SocialCrawl YouTube channel videos endpoint return?