Search YouTube videos by free-text query
search_videosSearch YouTube for videos matching a query, returning title, channel, duration, view count, and URL.
Instructions
Search YouTube for videos matching a query string. Returns up to limit results (default 10, max 25) with title, channel, duration, view count, and URL. Free — no credits charged. Use this when the user asks 'find me videos about X' before chaining into extract_transcript on a specific result.
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_videos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Free-text search query. Same syntax YouTube's own search bar accepts. | |
| limit | No | Max results to return (1–25, default 10). |