Search YouTube videos
search_videosSearch public YouTube videos by keyword and filter results by date, order, region, or channel to find relevant content and paginate through matches.
Instructions
Keyword search over public videos with date, order, region and channel filters. Costs ~100 quota units per call.
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 |
|---|---|---|---|
| order | No | Sort order: relevance, date, viewCount, rating, or title. | relevance |
| query | Yes | Search keywords. | |
| channel_id | No | Restrict results to this channel ID (UC...). | |
| page_token | No | next_page_token from a previous call, for the next page. | |
| max_results | No | Results per page, 1-50. | |
| region_code | No | ISO 3166-1 alpha-2 country code, e.g. US. | |
| published_after | No | Only videos published on/after this date (YYYY-MM-DD). | |
| published_before | No | Only videos published on/before this date (YYYY-MM-DD). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||