← API Store
Social
YouTube
YouTube
YouTube videos for a hashtag
GET /youtube/v1/hashtagEvery response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
hashtagrequired | string | Example: cooking |
cursor | string | Value of `next_cursor` from the previous page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 34,
"credits_used": 1,
"next_cursor": "4qmFsgLHBRIJRkVoYXNodGFnGqIFQ0NKNjRnTkRRMUZSUVVKcVZqaGxUSHB1YjNGQmJ6TlZXVFpNU0RSNlRrTlhlVFpGV2tkTlMyOTNaR1p6TkVrdGNuTlJSVmxmV2xSeGQwdHlWV3Ro…",
"shorts": [],
"summary": "42M videos • 4.2M channels",
"tag": "cooking",
"videos": [
{
"accessibility_label": "#masterlee Cooking 3D Bursting Eyeballs jelly |#viralvideo #satisfying #cooking #recipe #homemade by khmer food Cooking 41,310,219 views 2 …",
"badges": [],
"channel": "khmer food Cooking",
"channel_avatar": "https://yt3.ggpht.com/ytc/AIdro_nQIdulSkv8hR7_nW8GcmKQJ2ZRgqm_ZsjuAwhwEonAe8Q=s68-c-k-c0x00ffffff-no-rj",
"channel_id": "UCSJ3dDwN9krnijouI8K8VOg",
"channel_url": "https://www.youtube.com/channel/UCSJ3dDwN9krnijouI8K8VOg",
"channel_verified": true,
"description_snippet": null,
"duration": "0:15",
"duration_seconds": 15,
"id": "fM5a_ZvUt-o",
"is_live": false,
"is_playable": null,
"is_short": true,
"is_upcoming": false,
"moving_thumbnail": "https://i.ytimg.com/an_webp/fM5a_ZvUt-o/mqdefault_6s.webp?du=3000&sqp=CILQ7tYG&rs=AOn4CLDCU0mXf28GalQ3-WE2x-Im1-Emiw",
"owner_badges": [
"Verified"
],
"published": "2 years ago",
"scheduled_start": null,
"short_view_count": "41M views",
"thumbnail": "https://i.ytimg.com/vi/fM5a_ZvUt-o/hqdefault.jpg?sqp=-oaymwE2CNACELwBSFXyq4qpAygIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIFEoPjAP&rs=AOn…",
"thumbnails": [
{
"height": 94,
"url": "https://i.ytimg.com/vi/fM5a_ZvUt-o/hqdefault.jpg?sqp=-oaymwE1CKgBEF5IVfKriqkDKAgBFQAAiEIYAHABwAEG8AEB-AG2CIACgA-KAgwIABABGGUgUSg-MA8=&rs=AOn…",
"width": 168
},
{
"height": 110,
"url": "https://i.ytimg.com/vi/fM5a_ZvUt-o/hqdefault.jpg?sqp=-oaymwE1CMQBEG5IVfKriqkDKAgBFQAAiEIYAHABwAEG8AEB-AG2CIACgA-KAgwIABABGGUgUSg-MA8=&rs=AOn…",
"width": 196
},
"… 2 more"
],
"title": "#masterlee Cooking 3D Bursting Eyeballs jelly |#viralvideo #satisfying #cooking #recipe #homemade",
"url": "https://www.youtube.com/watch?v=fM5a_ZvUt-o",
"view_count": 41310219,
"views": "41,310,219 views"
},
{
"accessibility_label": "How to Cook Rice in a Coconut #bushcraft #cooking #camping by Mao Bushcraft 163,470,472 views 1 year ago 48 seconds - play Short",
"badges": [],
"channel": "Mao Bushcraft",
"channel_avatar": "https://yt3.ggpht.com/Cb59CBE-sM0kFWxeKru6FE2uiQ54xVXqLJJ0RyPwwM4jA-326_FD2CNrEhy2d03DQx3gvau0=s68-c-k-c0x00ffffff-no-rj",
"channel_id": "UCQtMSKIwjA_RQsBQ1gDXAFA",
"channel_url": "https://www.youtube.com/channel/UCQtMSKIwjA_RQsBQ1gDXAFA",
"channel_verified": true,
"description_snippet": null,
"duration": "0:48",
"duration_seconds": 48,
"id": "CFArDEL2_RQ",
"is_live": false,
"is_playable": null,
"is_short": true,
"is_upcoming": false,
"moving_thumbnail": "https://i.ytimg.com/an_webp/CFArDEL2_RQ/mqdefault_6s.webp?du=3000&sqp=CNDK7tYG&rs=AOn4CLC4-GqpQ4y0SzwHbDwINf2k4nxk2w",
"owner_badges": [
"Verified"
],
"published": "1 year ago",
"scheduled_start": null,
"short_view_count": "163M views",
"thumbnail": "https://i.ytimg.com/vi/CFArDEL2_RQ/hqdefault.jpg?sqp=-oaymwE2CNACELwBSFXyq4qpAygIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARhfIGUoOTAP&rs=AOn…",
"thumbnails": [
{
"height": 94,
"url": "https://i.ytimg.com/vi/CFArDEL2_RQ/hqdefault.jpg?sqp=-oaymwE1CKgBEF5IVfKriqkDKAgBFQAAiEIYAHABwAEG8AEB-AG2CIACgA-KAgwIABABGF8gZSg5MA8=&rs=AOn…",
"width": 168
},
{
"height": 110,
"url": "https://i.ytimg.com/vi/CFArDEL2_RQ/hqdefault.jpg?sqp=-oaymwE1CMQBEG5IVfKriqkDKAgBFQAAiEIYAHABwAEG8AEB-AG2CIACgA-KAgwIABABGF8gZSg5MA8=&rs=AOn…",
"width": 196
},
"… 2 more"
],
"title": "How to Cook Rice in a Coconut #bushcraft #cooking #camping",
"url": "https://www.youtube.com/watch?v=CFArDEL2_RQ",
"view_count": 163470472,
"views": "163,470,472 views"
},
"… 32 more"
]
} Response fields (41)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.next_cursor | string |
$.shorts | array |
$.summary | string |
$.tag | string |
$.videos | array |
$.videos[] | object | string |
$.videos[].accessibility_label | string |
$.videos[].badges | array |
$.videos[].channel | string |
$.videos[].channel_avatar | string |
$.videos[].channel_id | string |
$.videos[].channel_url | string |
$.videos[].channel_verified | boolean |
$.videos[].description_snippet | null |
$.videos[].duration | string |
$.videos[].duration_seconds | integer |
$.videos[].id | string |
$.videos[].is_live | boolean |
$.videos[].is_playable | null |
$.videos[].is_short | boolean |
$.videos[].is_upcoming | boolean |
$.videos[].moving_thumbnail | string |
$.videos[].owner_badges | array |
$.videos[].owner_badges[] | string |
$.videos[].published | string |
$.videos[].scheduled_start | null |
$.videos[].short_view_count | string |
$.videos[].thumbnail | string |
$.videos[].thumbnails | array |
$.videos[].thumbnails[] | object | string |
$.videos[].thumbnails[].height | integer |
$.videos[].thumbnails[].url | string |
$.videos[].thumbnails[].width | integer |
$.videos[].title | string |
$.videos[].url | string |
$.videos[].view_count | integer |
$.videos[].views | string |