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

# search_youtube

> YouTube search results for a keyword: about twenty videos with title, channel, views, duration and date, with filters. ₹0.29 per page; no results is ₹0.

## What it does

YouTube search results for `keyword`, in `data.videos[]`: `video_id`, `title`, `author` (the channel), `channel_id`, `view_count`, `duration`, `published_time`, `description_snippet` and `url`, about twenty per page with `data.continuation_token`. Filter with `upload_date`, `duration`, `features` and `sort_by`. Use it to find reviews, unboxings or creators on a topic; then [`get_youtube`](https://parel.si/docs/tools/get_youtube.md) for one video's exact numbers and [`get_youtube_comments`](https://parel.si/docs/tools/get_youtube_comments.md) for what viewers said.

India: put the language or market in the keyword ("protein bar review hindi"); there is no country knob.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `type` | string | no | video \| channel \| playlist \| movie. e.g. "video" |
| `keyword` | string | yes | required on the first request; omit when paging with continuation_token. e.g. "coffee" |
| `sort_by` | string | no | relevance \| upload_date \| view_count \| rating |
| `duration` | string | no | short (<4min) \| medium (4-20min) \| long (>20min) |
| `features` | string | no | comma-separated: live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr |
| `upload_date` | string | no | last_hour \| today \| this_week \| this_month \| this_year |
| `continuation_token` | string | no | pagination token for the next page |

## What drives the cost

Nothing: flat per page. Pass `continuation_token` (without `keyword`) for the next page. No results is `class: "ok_free"`, ₹0.

## Price today

| | |
|---|---|
| Price today | **₹0.29** per page (`cost_paise: 29`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.44 (`hold_paise: 44`); 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"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_youtube"` |
| 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","input":{"type":"video","keyword":"mamaearth review","upload_date":"this_year"}}'
```

## What comes back

`data.videos[]` and `data.continuation_token`. A real answer recorded during the live check of 2026-10-28, trimmed to two videos:

```json
{
  "keyword": "mamaearth review",
  "videos": [
    {
      "video_id": "KSslXTJile4",
      "title": "Doctor's Honest Review of Mama Earth",
      "duration": "13:03",
      "view_count": "133,041 views",
      "published_time": "6 years ago",
      "author": "Dr. Vanita Rattan ",
      "channel_id": "UC4u0qaMIAgOL8L37RwLcDQA",
      "thumbnails": [
        {
          "url": "https://i.ytimg.com/vi/KSslXTJile4/hq720.jpg",
          "width": 360,
          "height": 202
        },
        {
          "url": "https://i.ytimg.com/vi/KSslXTJile4/hq720.jpg",
          "width": 720,
          "height": 404
        }
      ],
      "description_snippet": "Download your Free E-Guide to Skin of Colour: https://bit.ly/3bWFUlF SKIN REVOLUTION Book - Order today at: ...",
      "url": "https://www.youtube.com/watch?v=KSslXTJile4"
    },
    {
      "video_id": "ZX7xy2WSuSw",
      "title": "Mamaearth Products Review: Worth Buying?",
      "duration": "12:01",
      "view_count": "189,263 views",
      "published_time": "4 years ago",
      "author": "Dr Nivedita Dadu ",
      "channel_id": "UCEQOJDwT1HlQO0Jmo-kLRrg",
      "thumbnails": [
        {
          "url": "https://i.ytimg.com/vi/ZX7xy2WSuSw/hq720.jpg",
          "width": 360,
          "height": 202
        },
        {
          "url": "https://i.ytimg.com/vi/ZX7xy2WSuSw/hq720.jpg",
          "width": 720,
          "height": 404
        }
      ],
      "description_snippet": "Book an Appointment- https://www.dadumedicalcentre.com/ Call: +91-9876543210 / +91-9876543210 There are multiple brands ...",
      "url": "https://www.youtube.com/watch?v=ZX7xy2WSuSw"
    },
    "… 18 more item(s) truncated"
  ],
  "shorts": [],
  "channels": [],
  "playlists": [],
  "continuation_token": "EqUDEhBtYW1hZWFydGggcmV2aWV3GpADRWdJUUFVZ1VnZ0VMUzFOemJGaFVTbWxzWlRTQ0FRdGFXRGQ0ZVRKWFUzVlRkNElCQzJkVWRHVXhUSE5RTmxkQmdnRUxNM0ppVWtsUFV6QnVZMVdDQVF0MlRtbDZRbXBmZG1kTWI0SUJDM2QzU1RFemQxTnlSbkF3Z2dFTGIwVmpVbW8xUmpoTllrMkNBUXRJUTFsbk1sWnpXVVpwYzRJQkMxcDBZV3hZYTB4dGNGQjNnZ0VMWkVwbmN6VmtOMWxTTm1lQ0FRczNOWEZrUjBaSWIwZzNaNElCQzJKRFdsQkJkRVY2YUZSRmdnRUxaMWhwT1VJMVJt…",
  "completion_suggestions": []
}
```

## Notes

- About 20 videos per page; pass continuation_token (without keyword) for the next page.
- No results is free. Usually one to three seconds.
- Counts come as text ("133,041 views"); get_youtube gives exact integers.

## Siblings

- [`get_youtube`](https://parel.si/docs/tools/get_youtube.md) for one video in full.
- [`get_youtube_channel`](https://parel.si/docs/tools/get_youtube_channel.md) for the creator behind it.
