YouTube search
youtube_searchSearch YouTube: one page of results in YouTube's order (about 20 videos, plus the Shorts and channels YouTube shows with them), each with title, views, length, age, channel and description snippet. Filter by result type, upload date, duration, sort order and features. First page: give query (and any filters). Next pages: give only cursor until next_cursor is null.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "youtube_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Order of the results. | relevance |
| type | No | Only results of one type. | all |
| query | No | The search terms, or a YouTube search link (its filters are kept). | |
| cursor | No | The next_cursor of the previous answer, exactly as returned, for the next page. Leave it out for the first page; with it, nothing else is needed. | |
| duration | No | Only videos of one length: short (under 4 minutes), medium (4 to 20 minutes), long (over 20 minutes). | any |
| features | No | Features every video must have. | |
| upload_date | No | Only videos uploaded in the last hour, today, this week, this month or this year. | any |