> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_youtube_hashtag

# 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`](https://parel.si/docs/tools/search_youtube.md) searches by keyword, [`get_youtube_trending_shorts`](https://parel.si/docs/tools/get_youtube_trending_shorts.md) 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

```bash
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:

```json
{
  "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

- [`search_youtube`](https://parel.si/docs/tools/search_youtube.md)
- [`get_youtube_trending_shorts`](https://parel.si/docs/tools/get_youtube_trending_shorts.md)
