Hashtag Videos

Path Parameters

string

required

The hashtag, without the leading # (e.g. shorts, lofi).

Query Parameters

string

default:"US"

Content region (ISO 3166-1 alpha-2). Examples: US, GB, DE, JP.

string

default:"en"

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

string

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

Response

string

The hashtag that was queried.

array

Array of videos under the hashtag (polymorphic SearchResult shape).

Show SearchResult object

string

Result type, e.g. video or short.

string

Video id (nullable).

string

Video title (nullable).

string

Full watch URL (nullable).

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

Uploader channel id (nullable).

string

Uploader channel name (nullable).

boolean

Whether the channel is verified (nullable).

boolean

Whether the item is a Short (nullable).

string

Token to fetch the next page (nullable when no more pages).

Example Response

{
  "tag": "lofi",
  "results": [
    {
      "type": "video",
      "video_id": "jfKfPfyJRdk",
      "title": "lofi hip hop radio - beats to relax/study to",
      "url": "https://www.youtube.com/watch?v=jfKfPfyJRdk",
      "thumbnail": "https://i.ytimg.com/vi/jfKfPfyJRdk/hqdefault.jpg",
      "view_count_text": "Live · 42K watching",
      "published_time_text": "Streamed 2 years ago",
      "channel_name": "Lofi Girl",
      "channel_is_verified": true,
      "is_short": false
    }
  ],
  "continuation": "4qmFsgKQARIaRkVoYXNodGFn..."
}

Each hashtag request costs 5 credits. Failed requests are not charged.

Overview

Search & Discovery

Videos & Shorts

Channels

Playlists & Community

Path Parameters

Query Parameters

Response

Example Response

​Path Parameters

​Query Parameters

​Response

​Example Response

Path Parameters

Query Parameters

Response

Example Response