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 for one video's exact numbers and get_youtube_comments 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
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:
{
"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_youtubefor one video in full.get_youtube_channelfor the creator behind it.
This page as Markdown: /docs/tools/search_youtube.md. Something wrong or missing: hello@parel.si.