Search channels
search_channelsSearch YouTube for channels (default) or playlists matching a query. Pass a channel's url to list_channel_videos or list_channel_playlists, and a playlist's url to list_playlist_videos.
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_channels"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | What to find: channel (default) or playlist. | channel |
| limit | No | Max results to return (1–50). Defaults to 5. | |
| query | Yes | Search keywords. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of rows returned. | |
| notice | No | Why a list is empty or may be incomplete, when the source says: e.g. "This channel has no Live tab." | |
| balance | No | Remaining credit balance after this call, when known. | |
| channels | No | Channels with ids, names, and URLs that list_channel_videos and list_channel_playlists accept directly. Present when type is channel. | |
| playlists | No | Playlists with ids, titles, and URLs that list_playlist_videos accepts directly. Present when type is playlist. | |
| creditsSpent | No | Credits charged for this call (0 on failure or for admins). | |
| creditsNotice | No | Credits words for the user, with the link that acts on them: why the call was refused for credits, or a note once the balance runs low. Pass it on to the user. |