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

> Returns detailed information about a specific YouTube video including title, view count, like count, comment count, description, tags, duration, channel info, and publish date.

TL;DR: `GET /v1/youtube/video` 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 |
| `language` | no | Preferred response language (mapped to Accept-Language header; not guaranteed due to YouTube localization behavior). 2 letter language code, ie 'en', 'es', 'fr' etc. |
| `hl` | no | Preferred response language for localized text (ISO 639-1, e.g. 'en', 'es', 'fr'). |

## Code example

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

## FAQ

### How do I get YouTube video data from a URL?

Send a GET request to /v1/youtube/video with url=https://www.youtube.com/watch?v=... and SocialCrawl returns title, view count, like count, comment count, duration, description, tags, channel info, and publish date as JSON.

### What fields does GET /v1/youtube/video return?

videoId, title, description, viewCount, likeCount, commentCount, duration, tags, publishedAt, channel (id, title, handle), thumbnails, and engagement_rate computed on our side from views and likes.

### Can I request the video data in a specific language?

Pass a 2-letter language=en, language=es, etc. and we forward it as Accept-Language. YouTube localizes titles and descriptions for many videos, though it's not guaranteed for every locale.

### How much does one video request cost?

1 credit per request. New accounts get 100 credits free, so you can pull around 100 video lookups before paying anything. No rate limits, pay-as-you-go billing.

### Is this faster than YouTube Data API v3?

In practice, yes — there is no per-day 10,000 quota cap, no OAuth consent flow, and no need to batch fields. One URL in, one JSON response out, typically within 1–3 seconds.

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 YouTube video view count, likes, and tags from a URL
- SocialCrawl YouTube video API vs Data API v3 comparison