Query Parameters
Content region (ISO 3166-1 alpha-2) whose trending feed to fetch. Examples: US, GB, DE, JP.
UI / interface language (BCP-47). Examples: en, de, fr, ja.
Which trending tab to return.| Value | Description |
|---|
now | Trending now (default) |
music | Trending music |
gaming | Trending gaming |
movies | Trending movies |
Continuation token from a previous response to fetch the next page.
Response
The region the feed was fetched for (nullable).
The trending tab that was returned (nullable).
Array of trending items.
Position in the feed (nullable).
Source category, e.g. Now, Music, Gaming (nullable).
Full watch URL (nullable).
Thumbnail variants with url, width, height.
Best thumbnail URL (nullable).
Human-readable duration (nullable).
Duration in seconds (nullable).
View count as displayed (nullable).
Relative publish time (nullable).
Short description snippet (nullable).
Uploader channel id (nullable).
Uploader channel name (nullable).
Uploader channel URL (nullable).
Uploader avatar URL (nullable).
Whether the channel is verified (nullable).
Whether the item is live (nullable).
Whether the item is a Short (nullable).
Token to fetch the next page (nullable when no more pages).
Example Response
{
"gl": "US",
"type": "now",
"items": [
{
"position": 1,
"category": "Now",
"video_id": "abc123XYZ_0",
"title": "The video everyone is watching today",
"url": "https://www.youtube.com/watch?v=abc123XYZ_0",
"thumbnail": "https://i.ytimg.com/vi/abc123XYZ_0/hqdefault.jpg",
"duration": "12:08",
"view_count": 4200000,
"view_count_text": "4.2M views",
"published_time_text": "18 hours ago",
"channel_name": "Trending Creator",
"channel_is_verified": true,
"is_live": false
}
],
"continuation": "4qmFsgKZARIYRkV0cmVuZGlu..."
}
| Endpoint | Returns |
|---|
GET /v1/youtube/trending/shorts | The trending Shorts shelf (items of Shorts). |
GET /v1/youtube/home | The guest home / recommendations feed (HomeResponse). |
Each trending or home request costs 5 credits. Failed requests are not charged.
