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.

FieldTypeRequiredDescription
typestringnovideo | channel | playlist | movie. e.g. "video"
keywordstringyesrequired on the first request; omit when paging with continuation_token. e.g. "coffee"
sort_bystringnorelevance | upload_date | view_count | rating
durationstringnoshort (<4min) | medium (4-20min) | long (>20min)
featuresstringnocomma-separated: live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr
upload_datestringnolast_hour | today | this_week | this_month | this_year
continuation_tokenstringnopagination 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 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"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_youtube"
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","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

This page as Markdown: /docs/tools/search_youtube.md. Something wrong or missing: hello@parel.si.