Find in videos
find_in_videosSearch several videos for the same keywords in one call and get back only the matching passages, grouped by video, plus which videos never mention them. Use it to check a set of search results or a channel's latest uploads for a topic without reading them all. Up to 5 videos per call, or 25 on the Ultra plan; each video counts as one request.
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": {
"videos": "<videos>",
"keywords": "<keywords>"
},
"name": "find_in_videos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Optional BCP-47 caption language code applied to every video. | |
| videos | Yes | YouTube URLs or 11-character video IDs. | |
| context | No | Paragraphs (about 30 seconds each) before and after each match. Default 1. | |
| keywords | Yes | Words or short phrases to look for (up to 8). Try synonyms and likely mis-hearings. | |
| max_hits_each | No | Passages to return per video. Default 3. |