Social platforms

YouTube channel search

from $0.0030 per eventyoutube.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.

FieldTypeRequiredWhat it does
keywordsarray of stringyesSearch 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.
glstringoptionalTwo-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.
hlstringoptionalLanguage 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.
sortstringoptionalResult 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.
maxItemsintegeroptionalCeiling 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.md

Or plain HTTP

POST /v1/run

{
  "endpoint": "youtube.channel_search",
  "input": {
    "sort": "r",
    "keywords": [
      "<keywords>"
    ]
  }
}

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