YouTube
General Search V2
Search content with type, sorting, duration, feature and upload-date filters.

You receive
Search content with type, sorting, duration, feature and upload-date filters.
Start with your task
General Search V2
Search content with type, sorting, duration, feature and upload-date filters.
The final charge is based on confirmed usage. Unused reserved credits return to your available balance.
YouTube
Search content with type, sorting, duration, feature and upload-date filters.

Search content with type, sorting, duration, feature and upload-date filters.
General Search V2
Inspect the current inputs, availability, and maximum charge before starting.
| Field / Path | Type | Requirement | Meaning |
|---|---|---|---|
queryParamsqueryParams | object | Optional | |
typequeryParams.type | string | null | Optional | Content type filter. |
keywordqueryParams.keyword | string | null | Optional | Search keyword; required for the first request.
|
sort_byqueryParams.sort_by | string | null | Optional | Sort order. |
durationqueryParams.duration | string | null | Optional | Duration filter: short (<4 min), medium (4-20 min) or long (>20 min). |
featuresqueryParams.features | string | null | Optional | Feature filter, comma-separated: live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d or hdr. |
upload_datequeryParams.upload_date | string | null | Optional | Upload date filter. |
continuation_tokenqueryParams.continuation_token | string | null | Optional | Continuation token for the next page. |
{
"type": "object",
"required": [],
"properties": {
"queryParams": {
"type": "object",
"properties": {
"type": {
"anyOf": [
{
"enum": [
"video",
"channel",
"playlist",
"movie"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Type",
"description": "Content type filter."
},
"keyword": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
],
"title": "Keyword",
"examples": [
"Python tutorial"
],
"description": "Search keyword; required for the first request."
},
"sort_by": {
"anyOf": [
{
"enum": [
"relevance",
"upload_date",
"view_count",
"rating"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Sort By",
"description": "Sort order."
},
"duration": {
"anyOf": [
{
"enum": [
"short",
"medium",
"long"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Duration",
"description": "Duration filter: short (<4 min), medium (4-20 min) or long (>20 min)."
},
"features": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Features",
"description": "Feature filter, comma-separated: live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d or hdr."
},
"upload_date": {
"anyOf": [
{
"enum": [
"last_hour",
"today",
"this_week",
"this_month",
"this_year"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Upload Date",
"description": "Upload date filter."
},
"continuation_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Continuation Token",
"description": "Continuation token for the next page."
}
},
"additionalProperties": true
}
},
"additionalProperties": false
}Output fields have not been documented yet.
Copy the note below into your agent’s chat. It reuses an existing connection or helps set one up.
Get connected
Tell your agent what you want to accomplish, including any constraints that matter.
General Search V2

I will inspect this tool, confirm the inputs and current cost, and check your authorization before running it. Then I will explain the result and its limits.
