Search YouTube
youtube_search_listSearch YouTube content by free-text keyword to find videos, Shorts, channels, or playlists; apply type, region, duration, upload date, and sort filters for targeted results.
Instructions
Search YouTube videos, channels, and playlists by free-text keyword (not hashtag — use youtube_search_hashtag_list for that). Requires query. Returns a list (use cursor when paginated). Example: {"query":"lofi beats","type":"videos"}. type takes plural values: videos, shorts, channels or playlists.
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>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "youtube_search_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Optional content type filter for search results. | |
| query | Yes | Required. Search query text for YouTube content. | |
| cursor | No | Opaque pagination cursor returned by a previous response. | |
| region | No | Optional ISO 3166-1 country code for localized search results. | |
| sortBy | No | Optional sort order for search results. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| duration | No | Optional duration filter for video results. Applies to videos, not shorts. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| uploadDate | No | Optional upload date filter for video results. | |
| includeExtras | No | When true, returns richer per-video metadata when available. May increase response time. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. |