Trending

Query Parameters

string

default:"US"

Content region (ISO 3166-1 alpha-2) whose trending feed to fetch. Examples: US, GB, DE, JP.

string

default:"en"

UI / interface language (BCP-47). Examples: en, de, fr, ja.

string

default:"now"

Which trending tab to return.

Value	Description
`now`	Trending now (default)
`music`	Trending music
`gaming`	Trending gaming
`movies`	Trending movies

string

Continuation token from a previous response to fetch the next page.

Response

string

The region the feed was fetched for (nullable).

string

The trending tab that was returned (nullable).

array

Array of trending items.

Show TrendingItem object

integer

Position in the feed (nullable).

string

Source category, e.g. Now, Music, Gaming (nullable).

string

Video id (nullable).

string

Video title (nullable).

string

Full watch URL (nullable).

array

Thumbnail variants with url, width, height.

string

Best thumbnail URL (nullable).

string

Human-readable duration (nullable).

integer

Duration in seconds (nullable).

integer

View count (nullable).

string

View count as displayed (nullable).

string

Relative publish time (nullable).

string

Short description snippet (nullable).

string

Uploader channel id (nullable).

string

Uploader channel name (nullable).

string

Uploader channel URL (nullable).

string

Uploader avatar URL (nullable).

boolean

Whether the channel is verified (nullable).

array

Item badges.

boolean

Whether the item is live (nullable).

boolean

Whether the item is a Short (nullable).

string

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.

Overview

Search & Discovery

Videos & Shorts

Channels

Playlists & Community

Query Parameters

Response

Example Response

​Query Parameters

​Response

​Example Response

​Related Feeds

Query Parameters

Response

Example Response

Related Feeds