Search YouTube
search_youtubeSearches YouTube videos by keyword and returns up to 20 videos (title, url, channel, published_at, views, duration, description), localized by country and language. It does not return transcripts (use youtube_transcript with a video ID), comments or channel pages. 5 credits per successful call; a search with no matches is charged, errors are not. Required: query.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_youtube"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Video search text, 1-500 characters, e.g. "espresso tutorial". | |
| country | No | Two-letter country code that localizes the videos, e.g. "it" or "gb". Omit for the source default, us. | |
| results | No | Maximum videos returned, integer 1-20, default 10, e.g. 5. | |
| language | No | Two-letter language code for the results, e.g. "en" or "it". Omit for the source default, en. |