YouTube Mixed Search, United States (English, Videos, Shorts and Channels, First Page)
omnial/youtube-web-v2-get-general-search
Given a search keyword, returns the first page of YouTube's mixed search results as a United States search in English, in page order: for each video its ID, title, channel name and channel ID, channel badge, how long ago it was published, length, view count text and badges; each Shorts shelf's heading and, per Short, its video ID, title and view count text; for a channel result its ID, name, handle, subscriber count text and badge; plus YouTube's estimated total result count.
activeper callv1
Price
Up to $0.00205 per call; you pay what the call used
The price shown is the price you pay. No monthly minimum. Top-ups start at $5.
Data source
YouTube
Data from YouTube.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/youtube-web-v2-get-general-search" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/youtube-web-v2-get-general-search" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/youtube-web-v2-get-general-search", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/youtube-web-v2-get-general-search", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.00205 |
- Updated
- Oct 14, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"search_query",
"language_code",
"country_code",
"time_zone"
],
"properties": {
"time_zone": {
"enum": [
"America/Los_Angeles"
],
"type": "string",
"description": "The time zone; only \"America/Los_Angeles\", the one tested, is offered."
},
"country_code": {
"enum": [
"US"
],
"type": "string",
"description": "The country results are taken from; only \"US\" is offered."
},
"search_query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The search keyword or phrase."
},
"language_code": {
"enum": [
"en-US"
],
"type": "string",
"description": "The interface language; only \"en-US\" (English, United States) is offered."
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"contents": {
"type": "object",
"properties": {
"twoColumnSearchResultsRenderer": {
"type": "object",
"properties": {
"primaryContents": {
"type": "object",
"properties": {
"sectionListRenderer": {
"type": "object",
"properties": {
"contents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"itemSectionRenderer": {
"type": "object",
"properties": {
"contents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"videoRenderer": {
"type": "object",
"properties": {
"title": {
"type": "object",
"properties": {
"runs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The video's title, in one or more text runs."
}
}
}
}
}
},
"badges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"metadataBadgeRenderer": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "A badge on the video, such as New."
}
}
}
}
}
},
"videoId": {
"type": "string",
"description": "The video's ID."
},
"ownerText": {
"type": "object",
"properties": {
"runs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The channel's name."
},
"navigationEndpoint": {
"type": "object",
"properties": {
"browseEndpoint": {
"type": "object",
"properties": {
"browseId": {
"type": "string",
"description": "The channel's ID (UC...)."
}
}
}
}
}
}
}
}
}
},
"lengthText": {
"type": "object",
"properties": {
"simpleText": {
"type": "string",
"description": "The video's length, as display text (h:mm:ss)."
}
}
},
"ownerBadges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"metadataBadgeRenderer": {
"type": "object",
"properties": {
"tooltip": {
"type": "string",
"description": "A channel badge's label, such as Verified."
}
}
}
}
}
},
"viewCountText": {
"type": "object",
"properties": {
"simpleText": {
"type": "string",
"description": "The view count, as display text."
}
}
},
"publishedTimeText": {
"type": "object",
"properties": {
"simpleText": {
"type": "string",
"description": "How long ago it was published, as display text."
}
}
},
"shortViewCountText": {
"type": "object",
"properties": {
"simpleText": {
"type": "string",
"description": "The view count, abbreviated, as display text."
}
}
}
},
"description": "A video result."
},
"channelRenderer": {
"type": "object",
"properties": {
"title": {
"type": "object",
"properties": {
"simpleText": {
"type": "string",
"description": "The channel's name."
}
}
},
"channelId": {
"type": "string",
"description": "The channel's ID (UC...)."
},
"ownerBadges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"metadataBadgeRenderer": {
"type": "object",
"properties": {
"tooltip": {
"type": "string",
"description": "A channel badge's label, such as Verified."
}
}
}
}
}
},
"videoCountText": {
"type": "object",
"properties": {
"simpleText": {
"type": "string",
"description": "The channel's subscriber count, as display text (YouTube puts it in this field)."
}
}
},
"subscriberCountText": {
"type": "object",
"properties": {
"simpleText": {
"type": "string",
"description": "The channel's @handle (YouTube puts it in this field)."
}
}
}
},
"description": "A channel result."
},
"gridShelfViewModel": {
"type": "object",
"properties": {
"header": {
"type": "object",
"properties": {
"sectionHeaderViewModel": {
"type": "object",
"properties": {
"headline": {
"type": "object",
"properties": {
"content": {
"type": "string",
"description": "The shelf's heading."
}
}
}
}
}
}
},
"contents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"shortsLockupViewModel": {
"type": "object",
"properties": {
"onTap": {
"type": "object",
"properties": {
"innertubeCommand": {
"type": "object",
"properties": {
"reelWatchEndpoint": {
"type": "object",
"properties": {
"videoId": {
"type": "string",
"description": "The Short's video ID."
}
}
}
}
}
}
},
"overlayMetadata": {
"type": "object",
"properties": {
"primaryText": {
"type": "object",
"properties": {
"content": {
"type": "string",
"description": "The Short's title as shown."
}
}
},
"secondaryText": {
"type": "object",
"properties": {
"content": {
"type": "string",
"description": "The Short's abbreviated view count text."
}
}
}
}
}
}
}
}
},
"description": "The Shorts on the shelf."
}
},
"description": "A shelf of Shorts."
}
}
},
"description": "One entry per result block, in page order: a video, a Shorts shelf or a channel."
}
}
}
}
},
"description": "The page's result sections."
}
}
}
}
}
}
}
}
},
"estimatedResults": {
"type": "string",
"description": "YouTube's estimate of the total number of results, as a string of digits."
}
},
"description": "The first page of search results."
}