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

> Returns the most popular (trending) YouTube videos for a region and category — title, thumbnail, duration, view/like/comment counts, channel, and publish time — plus a `cursor` when more results are available. Filter by `region` (ISO country) and `category` (YouTube category id); forward `cursor` for subsequent pages.

TL;DR: `GET /v1/youtube/videos/trending` 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 |
| --- | --- | --- |
| `region` | no | ISO 3166-1 alpha-2 country code (e.g. US, GB, KR). |
| `category` | no | YouTube video category id (e.g. 10 = Music, 24 = Entertainment). |
| `language` | no | Localization language (ISO 639-1) for titles/metadata. |
| `max_results` | no | Maximum number of videos to return (1–50). |
| `cursor` | no | Pagination cursor from a previous response — fetches the next page. |

## Code example

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

## FAQ

### How do I get trending YouTube videos via API?

Send a GET to /v1/youtube/videos/trending with a region and optional category. The response lists the most popular videos with title, thumbnail, duration, view, like and comment counts, channel, and publish time.

### Can I get trending videos for a specific country?

Yes. Pass region with an ISO country code like US, GB, or KR to get that country's trending list. Add category (for example 10 for Music) to narrow it further.

### How do I page through more trending results?

Each response includes a cursor when more results exist. Forward it as cursor=... on the next request to fetch the next page.

### How many trending videos can I request at once?

Use max_results to set a page size from 1 to 50. Combine it with the cursor to walk the full trending feed for a region.

### How much does the trending endpoint cost?

It is a standard endpoint at 1 credit per request, and every new account starts with 100 free credits.

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 trending YouTube videos by country via API
- YouTube trending videos API without Data API quota