youtube_search
Search YouTube videos with filters for date range, duration, quality, region, and sorting to find specific content efficiently.
Instructions
Search for videos on YouTube with advanced filtering options
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| maxResults | No | Maximum number of results (1-50) | |
| order | No | Sort order for results | relevance |
| publishedAfter | No | Filter videos published after this date (ISO 8601 format) | |
| publishedBefore | No | Filter videos published before this date (ISO 8601 format) | |
| query | Yes | Search query for YouTube videos | |
| regionCode | No | Region code for localized results (e.g., "US", "GB") | |
| videoDefinition | No | Filter by video quality | any |
| videoDuration | No | Filter by video duration | any |
Input Schema (JSON Schema)
{
"properties": {
"maxResults": {
"default": 10,
"description": "Maximum number of results (1-50)",
"maximum": 50,
"minimum": 1,
"type": "number"
},
"order": {
"default": "relevance",
"description": "Sort order for results",
"enum": [
"relevance",
"date",
"rating",
"viewCount",
"title"
],
"type": "string"
},
"publishedAfter": {
"description": "Filter videos published after this date (ISO 8601 format)",
"type": "string"
},
"publishedBefore": {
"description": "Filter videos published before this date (ISO 8601 format)",
"type": "string"
},
"query": {
"description": "Search query for YouTube videos",
"type": "string"
},
"regionCode": {
"description": "Region code for localized results (e.g., \"US\", \"GB\")",
"type": "string"
},
"videoDefinition": {
"default": "any",
"description": "Filter by video quality",
"enum": [
"any",
"high",
"standard"
],
"type": "string"
},
"videoDuration": {
"default": "any",
"description": "Filter by video duration",
"enum": [
"any",
"short",
"medium",
"long"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}