# YouTube Video Comments API (https://www.socialcrawl.dev/platforms/youtube/video-comments)

> Returns a list of comments on a specific YouTube video. Each comment includes the author name, comment text, like count, reply count, and publish timestamp.

TL;DR: `GET /v1/youtube/video/comments` 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 |
| --- | --- | --- |
| `url` | yes | Full URL of the YouTube video to fetch comments for |
| `continuationToken` | no | Continuation token to get more comments. Get 'continuationToken' from previous response. |
| `order` | no | Order of comments (top \| newest) |
| `searchTerm` | no | Filter comments to those containing this search term. |
| `format` | no | Text format for comment bodies — 'html' (default) or 'plainText'. (html \| plainText) |
| `max_results` | no | Maximum number of comments to return per page. |
| `channel_id` | no | YouTube channel id to fetch channel-level community comments for (instead of a video's comments). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/youtube/video/comments?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I scrape comments from a YouTube video?

Send a GET request to /v1/youtube/video/comments with the video URL in the url parameter. The response includes author name, comment text, like count, reply count, and publish timestamp for each comment.

### Can I sort comments by top or newest?

Yes. Pass order=top for the most-liked comments first, or order=newest for reverse-chronological order. Default is top, which matches YouTube's default UI sort.

### How do I paginate through every comment?

Each response returns a continuationToken. Pass it as continuationToken=... on the next call to get the next page. Keep going until the token is empty — no total-count cap.

### How do I get replies to a specific comment?

Every comment with replies exposes a repliesContinuationToken. Pass it to /v1/youtube/video/comment/replies to fetch the full reply thread with author, text, likes, and publish date.

### Is this good for YouTube sentiment analysis?

Yes — you get clean comment text with author and engagement counts, ready to feed into an LLM or classifier. Batch it with the video endpoint to pair comments with video metadata.

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 scrape YouTube comments for sentiment analysis
- What fields does SocialCrawl YouTube comments API return?