Social platforms

YouTube videos

from $0.0090 per resultyoutube.videos

YouTube videos from a search term, channel, playlist or direct URL, with title, channel, view and like counts, duration, upload date, description and hashtags.

What a call costs

Billed on actual usage, minimum $0.0020 per call, capped at $6.00 per call.

a price before every call. failed calls are never charged.

When to use it

Use to find videos on a topic, pull a channel's or playlist's catalogue, or enrich known video URLs with their stats. Subtitles and the two AI add-ons are billed extra per video, so leave them off unless you need them.

Inputs

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

FieldTypeRequiredWhat it does
is3DbooleanoptionalsearchQueries filter: 3D videos only.
is4KbooleanoptionalsearchQueries filter: 4K videos only.
isHDbooleanoptionalsearchQueries filter: HD videos only.
hasCCbooleanoptionalsearchQueries filter: Creative Commons licensed videos only.
is360booleanoptionalsearchQueries filter: 360 degree videos only.
isHDRbooleanoptionalsearchQueries filter: HDR videos only.
isLivebooleanoptionalsearchQueries filter: live videos only.
isVR180booleanoptionalsearchQueries filter: VR180 videos only.
isBoughtbooleanoptionalsearchQueries filter: purchased videos only.
startUrlsarray of objectoptionalDirect YouTube video, channel, playlist, hashtag or results-page URLs
videoTypestringoptional
dateFilterstringoptionalUpload-date filter for search. COSTS EXTRA on channel inputs: the date-range add-on is billed $0.001 per video on top of the result
maxResultsintegeroptionalMaximum regular videos per search term or channel. Billed per video
hasLocationbooleanoptionalsearchQueries filter: videos tagged with a location.
hasSubtitlesbooleanoptionalsearchQueries filter: videos that have subtitles or closed captions.
lengthFilterstringoptional
sortVideosBystringoptionalSort order on a channel's Videos, Shorts and Live tabs
sortingOrderstringoptional
searchQueriesarray of stringoptionalSearch terms, exactly as you would type them into YouTube's search bar. maxResults applies to EACH term
aiVideoSummarybooleanoptionalPAID ADD-ON. AI conceptual summary of each video, billed $0.01 per video on top of the $0.003 result
oldestPostDatestringoptionalOnly videos uploaded on or after this date, e.g. 2026-01-31, or a relative age like "7 days"
subtitlesFormatstringoptional
maxResultStreamsintegeroptionalMaximum live streams per search term or channel. Billed per video
maxResultsShortsintegeroptionalMaximum Shorts per search term or channel. Billed per video
downloadSubtitlesbooleanoptionalDownload the video's subtitles
subtitlesLanguagestringoptional
aiVideoDescriptionbooleanoptionalPAID ADD-ON. AI time-segmented description of each video, billed $0.01 per video on top of the $0.003 result
preferAutoGeneratedSubtitlesbooleanoptionalPrefer YouTube's automatic captions over creator-uploaded ones. Only does anything with downloadSubtitles on and subtitlesLanguage set.

How to call it

Connect once and your agent can reach YouTube videos 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.videos",
  "input": {
    "maxResults": 10,
    "aiVideoSummary": false,
    "maxResultStreams": 0,
    "maxResultsShorts": 0,
    "aiVideoDescription": false
  }
}

Run YouTube videos from your agent.

One balance for every tool in the catalog. Start with Build, $25 of credit for $19 a month.

Get started