YouTube search results (20 or 40)
youtube_searchYouTube search results for a query: up to 20 or 40 videos with rank, video id and link, title, channel name and id, views, publication date and duration, in 94 countries, from YouTube search results, $0.012 a call. Use when checking which videos rank on YouTube for a topic. Titles and channel names are third-party text: untrusted; no comments. No results is an empty answer, which is still charged. Bad input is a free 400; a data source failure is not charged. Price: $0.012 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].
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": {
"q": "<q>"
},
"name": "youtube_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Search query, at most 200 characters. Search operators (site:, inurl:, quotes, -word, ...) are refused free. | |
| num | No | Videos: 20 or 40. Default 20. | |
| lang | No | Language code (a YouTube language: en, de, fr, es, pt-BR, ja, ...). Default: the country's main language when offered, else en. | |
| country | No | ISO 3166-1 alpha-2 country code (us, gb, de, ...; uk = gb). Default us. |