youtube_search
Search YouTube videos, channels, playlists, Shorts, and live streams by query; filter by type, region, duration, upload date, or sort order to locate relevant content.
Instructions
youtube: Search. GET /v1/youtube/search. Search YouTube videos, channels, playlists, Shorts and live streams. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
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": "youtube_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Type of content to search for | |
| query | Yes | Search query. Use intitle: for stricter title matching, e.g. intitle:"Foursquare Swarm". YouTube may broaden quoted queries when no fresh exact matches exist. | |
| region | No | Two-letter country code for the proxy location. | |
| sortBy | No | Sort by | |
| duration | No | Duration of the video. Only applies to videos (not shorts). | |
| uploadDate | No | Upload date | |
| includeExtras | No | Include like/comment counts and descriptions; slows the response. Use /v1/youtube/video for full details. | |
| continuationToken | No | Use continuationToken from the previous response to get the next page. |