Hashtag Videos

Path Parameters

tag

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.

continuation

string

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

Response

tag

string

The hashtag that was queried.

results

array

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

Show SearchResult object

type

string

Result type, e.g. video or short.

video_id

string

Video id (nullable).

title

string

Video title (nullable).

url

string

Full watch URL (nullable).

thumbnail

string

Best thumbnail URL (nullable).

duration

string

Human-readable duration (nullable).

length_seconds

integer

Duration in seconds (nullable).

view_count

integer

View count (nullable).

view_count_text

string

View count as displayed (nullable).

published_time_text

string

Relative publish time (nullable).

channel_id

string

Uploader channel id (nullable).

channel_name

string

Uploader channel name (nullable).

channel_is_verified

boolean

Whether the channel is verified (nullable).

is_short

boolean

Whether the item is a Short (nullable).

continuation

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