search_youtube_hashtag
The videos YouTube lists under a hashtag: title, link, views, date and channel. ₹0.28 per page; a result that finds nothing is ₹0.
What it does
The videos YouTube lists for a hashtag (without the #): data with each video's title, url, thumbnail, views, publish date, duration and channel, plus a continuationToken for the next page; type shorts keeps to Shorts.
Use it to see what is published under a campaign or trend tag; search_youtube searches by keyword, get_youtube_trending_shorts shows what is viral now. Flat price per page; a tag with no videos is free. One to four seconds.
India: Indian campaign tags (#Diwali2026, #IPL) are well populated.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
type | string | no | all (default) or shorts. |
hashtag | string | yes | The hashtag, without the #. |
continuationToken | string | no | The token from the previous answer, for the next page. |
What drives the cost
Flat per page; pass continuationToken for the next page. A result that finds nothing is class: "ok_free", ₹0. The timeout is 30 seconds.
Price today
| Price today | ₹0.28 per page (cost_paise: 28) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.42 (hold_paise: 42); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0 |
| Timeout | 30 s, then upstream_timeout (₹0, retryable) |
| Over MCP | run_tool with tool: "search_youtube_hashtag" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "search_youtube_hashtag" |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |
Request
curl https://api.parel.si/v1/run \
-H "Authorization: Bearer $PAREL_KEY" \
-H "Content-Type: application/json" \
-d '{"tool":"search_youtube_hashtag","input":{"type":"all","hashtag":"skincareroutine"}}'
What comes back
data, as the live check of 2026-11-05 recorded it, trimmed:
{
"videos": [],
"shorts": [
{
"type": "short",
"id": "PhldlbEEF-E",
"url": "https://www.youtube.com/watch?v=PhldlbEEF-E",
"title": "SkinQueen is my secret 😍 #acne #skincare #brightskin #skincareroutine #acnetreatment #skin #beauty",
"viewCountText": "12K",
"viewCountInt": 12000
},
{
"type": "short",
"id": "YSTa88FQdMk",
"url": "https://www.youtube.com/watch?v=YSTa88FQdMk",
"title": "which is best acc. to you? 🔆 | #skincare #skincareroutine #beauty #makeup #skincaretips",
"viewCountText": "3.9K",
"viewCountInt": 3900
},
{
"type": "short",
"id": "KtVN9anbv7s",
"url": "https://www.youtube.com/watch?v=KtVN9anbv7s",
"title": "Budget/Affordable Skincare Routine for All Skin Types #skincareroutine #skincareproducts",
"viewCountText": "41K",
"viewCountInt": 41000
}
],
"continuationToken": "EjESEiIjc2tpbmNhcmVyb3V0aW5lIhoYU0JTeUFRWUtCQWdDRUFMcUFRUUlBaEFaoAIEGIHg6BgiC3NlYXJjaC1mZWVk"
}
Notes
- Flat per page; pass continuationToken for the next page.
- type shorts for Shorts only.
- A tag with no videos is free.
Siblings
This page as Markdown: /docs/tools/search_youtube_hashtag.md. Something wrong or missing: hello@parel.si.