YouTube Search
Search public YouTube videos through AIAPI Center and return normalized video evidence rows.
What it does
YouTube is often where launch videos, tutorials, reviews, and creator reactions appear before they become indexed web pages. This connector searches public YouTube videos through AIAPI Center and returns normalized video rows with title, URL, channel, publish time, duration, public metrics, and source limitations.
Inputs
| Parameter | Format | Example | Required |
|---|---|---|---|
query | string | AI agent workflows | Yes |
limit | number | 5 | No |
order | date | rating | relevance | title | viewCount | date | No |
region_code | string | US | No |
Outputs
| Field | Type | Description |
|---|---|---|
matchedVideos | number | Number of public videos returned for the query |
topTitle | string | Title of the top returned video |
topUrl | string | Canonical YouTube watch URL for the top video |
items | array | Normalized video rows with channel, metrics, duration, source mode, and limitations |
Example output
Input
query: "AI agent workflows" limit: 5 order: "date" region_code: "US"
Output
# YouTube Search Results - Query: AI agent workflows - Matched Videos: 5 - Top Title: AI Agent Workflows - Top URL: https://www.youtube.com/watch?v=abc123def45
What it means
Five public videos matched the query. The top row includes normalized YouTube metadata and public metrics from the official API.
Last tested: 2026-06-04
How to install
Via CLI
Via web
- Visit the connector catalog and find YouTube Search.
- Click Install connector and acknowledge any training requirements.
- Complete authorization if prompted.
- Use the connector from Chat or the CLI.
Auth and permissions
| OAuth required | No |
| Managed auth | Included, no API key needed |
| Bring your own key (BYOK) | Not supported in v1 |
| Audit logged | Every request is logged with input, result, cost, and timestamps |
| Training acknowledgment | Not required |
Admins can restrict this connector via blacklist or whitelist in the admin panel.
Limits and edge cases
- •Only public videos returned by YouTube Data API are available.
- •Default limit is 5 results; maximum is 50.
- •Transcript text is not returned in this version.
- •Public metrics can lag the values shown on YouTube watch pages.
Common use cases
Find recent launch and tutorial videos
Search YouTube before writing a market scan or launch brief.
Collect video evidence for creator research
Return normalized video rows that agents can cite, rank, and summarize.
Monitor a topic by recency or popularity
Use order and region filters to focus on fresh or high-view public videos.
Frequently asked questions
Does this return transcripts?
No. v1 returns video metadata and public metrics, not transcript text.
Which videos are supported?
Only publicly available YouTube videos returned by the official YouTube Data API.
Related connectors
YouTube Video Read
Read a public YouTube video by URL or ID through AIAPI Center and return normalized metadata and metrics.
Web Search
Search the open web through Vernclaw's managed retrieval stack.
X Search
Run advanced X search queries and normalize the top matching public posts.