YouTube channel search
YouTube channels matching a topic keyword, ranked by YouTube's own channel search, each with subscriber count, lifetime views, video count, creation date, description and topic tags.
What a call costs
Billed on actual usage, minimum $0.0020 per call, capped at $0.10 per call.
a price before every call. failed calls are never charged.
When to use it
Use when you need to find WHO covers a topic on YouTube and do not have a handle yet: building a creator shortlist, mapping who owns a niche, or sizing a competitive field before you commit. Returns channels, not videos, so it does not reward whoever titled one video well. Billing is one unit per search TERM and the rows are free, so ask for a large maxItems on few terms rather than the reverse. Use youtube.channel when you already know the handle, youtube.similar_channels when you have one channel and want others like it, and youtube.videos when you want videos rather than the channels behind them.
Inputs
YouTube channel search takes 5 fields, 1 of them required. Anything you leave out falls back to the tool's own default.
| Field | Type | Required | What it does |
|---|---|---|---|
| keywords | array of string | yes | Search terms, exactly as you would type them into YouTube's search box. Each term is one billed unit and maxItems applies to EACH term, so this array's length is what you pay for. Capped at 10 terms per call. |
| gl | string | optional | Two-letter country code, lowercase, passed to YouTube as the gl query parameter. Changes which channels rank for the term, so it is the field to set when you want the creators in one market rather than the global set. The actor uses us when you leave it out. |
| hl | string | optional | Language code, lowercase, passed to YouTube as the hl query parameter, e.g. en, de, ro. Affects the language of returned descriptions and tags. The actor uses en when you leave it out. |
| sort | string | optional | Result ordering: r relevance, ra rating, u upload date, v view count. Defaulted to r and always sent, because the actor returns ZERO results and charges nothing when this field is absent, which is indistinguishable from a topic having no channels. Change it freely, but do not send it empty. |
| maxItems | integer | optional | Ceiling on channels returned per term. This does NOT change the price: billing is one event per search term, not per channel returned, so a high value costs exactly what a low one costs. Ask for more rather than less. |
How to call it
Connect once and your agent can reach YouTube channel search the same way it reaches everything else in the catalog. Add Goro as an MCP connector, or paste the setup line into an agent that reads skills.
MCP
Add this server in Claude, Claude Code, or any MCP client.
https://mcp.usegoro.ai/mcp
Skill
One line in your agent's chat. It sets itself up.
set up https://usegoro.ai/SKILL.mdOr plain HTTP
POST /v1/run
{
"endpoint": "youtube.channel_search",
"input": {
"sort": "r",
"keywords": [
"<keywords>"
]
}
}Related tools
More from social platforms, or browse the full tool catalog.
YouTube comments
Comments on one or more YouTube videos, with author, comment text, vote count, reply count, whether the channel owner wrote it, and how long ago it...
from $0.0045 per resultYouTube similar channels
Channels similar to one or more seed channels, ranked by what they actually publish rather than by keyword, each with a 0 to 1 similarity score,...
from $0.36 per resultYouTube transcript
Full transcript of a YouTube video as timestamped lines and optionally as one plain text block, alongside the video's title, channel, duration, view...
from $0.0150 per resultYouTube trending
The videos on YouTube's trending shelf for one country right now, in rank order, each with view, like and comment counts, duration, category, publish...
from $0.0750 per eventFurther reading: Social listening with AI agents: track mentions, trends and competitors
Run YouTube channel search from your agent.
One balance for every tool in the catalog. Start with Build, $25 of credit for $19 a month.
Get started