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

> Fetches full details for up to 1000 YouTube videos by id in a single POST request. Each item is the same unified video object as GET /v1/youtube/video. Body: { ids: string[], includeLocalizations?: boolean }. Metered per 50-id chunk.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `ids` | yes | JSON array of BARE YouTube video ids (11 characters each, e.g. 'dQw4w9WgXcQ'), 1 to 1000 per request. Unlike GET /v1/youtube/video, full watch URLs are not accepted here. |
| `hl` | no | Preferred response language for localized text (ISO 639-1, e.g. 'en', 'ko'). |
| `include_localizations` | no | When true, includes per-language title/description localizations in each item's ext. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/youtube/videos?ids=dQw4w9WgXcQ%2C9bZkp7q19f0" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I fetch many YouTube videos in one request?

Send a POST to /v1/youtube/videos with a body of { ids: [...] } holding up to 1,000 bare video IDs. Each item comes back as the same unified video object you get from the single-video endpoint.

### What ID format does the batch video endpoint accept?

Bare 11-character video IDs like dQw4w9WgXcQ, not full watch URLs. Pass 1 to 1,000 of them per request in the ids array.

### How is the batch video endpoint billed?

It is metered per 50-ID chunk, so a request for 200 IDs bills as four chunks. Batch endpoints are advanced tier, and every new account starts with 100 free credits.

### Is the response shape the same as the single video endpoint?

Yes. Each entry in the list is identical to GET /v1/youtube/video, so you reuse the same parsing code whether you fetch one video or a thousand.

### Can I request localized titles and descriptions?

Yes. Set include_localizations to true and pass hl with an ISO 639-1 code like en or ko to get per-language title and description text in each item's ext.

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 fetch thousands of YouTube video details in one API call
- Batch YouTube video metadata API without Data API quota