Path Parameters
The hashtag, without the leading # (e.g. shorts, lofi).
Query Parameters
Content region (ISO 3166-1 alpha-2). Examples: US, GB, DE, JP.
UI / interface language (BCP-47). Examples: en, de, fr, ja.
Continuation token from a previous response to fetch the next page.
Response
The hashtag that was queried.
Array of videos under the hashtag (polymorphic SearchResult shape).
Result type, e.g. video or short.
Full watch URL (nullable).
Best thumbnail URL (nullable).
Human-readable duration (nullable).
Duration in seconds (nullable).
View count as displayed (nullable).
Relative publish time (nullable).
Uploader channel id (nullable).
Uploader channel name (nullable).
Whether the channel is verified (nullable).
Whether the item is a Short (nullable).
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.
