Social platforms

YouTube 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 date and the channel behind it.

When to use it

Use when the question is what YouTube is pushing RIGHT NOW rather than what matches a search term: spotting a format or topic while it is surfacing, checking whether a niche is having a moment in one market, or sampling what the algorithm currently rewards. This is the trending shelf itself, which is not the same set as a search: it is where a format shows up before anyone searches for it by name. Use youtube.videos for search terms and channel catalogues, trends.search for Google search demand (it cannot be scoped to YouTube), and tiktok.api for the equivalent on TikTok. One country per call, since gl takes a single code, so a five-market sweep is five calls. Price is FLAT per call: 100 videos cost exactly what 5 cost, so always ask for more. Be careful piping this straight into a context window, rows carry full streaming and caption metadata and run roughly 38 KB each.

Inputs

YouTube trending takes 2 fields, none of them required. Anything you leave out falls back to the tool's own default.

How to call it

Connect once and your agent can reach YouTube trending 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.

Or plain HTTP

POST /v1/run

{
  "endpoint": "youtube.trending",
  "input": {
    "gl": "<gl>"
  }
}