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.

FieldTypeRequiredDescription
typestringnoall (default) or shorts.
hashtagstringyesThe hashtag, without the #.
continuationTokenstringnoThe 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "search_youtube_hashtag"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_youtube_hashtag"
Confirmationnot 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.