youtube.search
ActiveTool of Vee3
Search public YouTube content by keyword or phrase. Returns matching result cards, estimated result count, and spelling suggestions. Use filter parameters to apply multiple YouTube search filters: - upload_date: Last hour, Today, This week, This month, This year - content_type: Video, Channel, Playlist, Movie - duration: Under 4 minutes, 4 - 20 minutes, Over 20 minutes - features: Live, 4K, HD, Subtitles/CC, Creative Commons, 360°, VR180, 3D, HDR, Location, Purchased (multiple allowed) - sort_by: Relevance, Upload date, View count, Rating Filter values are matched case-insensitively. Only one option per group applies except features, which accepts multiple labels. When a requested filter cannot be applied, the API returns the best-effort results available so far and includes unappliedFilters with the labels that were skipped. Use cursor with the same query to paginate: pass cursorNext from a prior response. Filter parameters and cursor cannot be combined. Check didYouMean when the query may be misspelled. Cost = 20 tokens.
Parameters schema
{
"type": "object",
"title": "search_youtubeArguments",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"title": "Query",
"maxLength": 512,
"description": "Search keywords or phrase."
},
"cursor": {
"anyOf": [
{
"type": "string",
"maxLength": 4096
},
{
"type": "null"
}
],
"title": "Cursor",
"default": null,
"description": "Pagination cursor from cursorNext."
},
"sort_by": {
"anyOf": [
{
"type": "string",
"maxLength": 128
},
{
"type": "null"
}
],
"title": "Sort By",
"default": null,
"description": "Sort order. One of: Relevance, Upload date, View count, Rating."
},
"duration": {
"anyOf": [
{
"type": "string",
"maxLength": 128
},
{
"type": "null"
}
],
"title": "Duration",
"default": null,
"description": "Duration filter. One of: Under 4 minutes, 4 - 20 minutes, Over 20 minutes."
},
"features": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
},
"maxItems": 6
},
{
"type": "null"
}
],
"title": "Features",
"default": null,
"description": "Feature filters. Multiple allowed. Each value must be one of: Live, 4K, HD, Subtitles/CC, Creative Commons, 360°, VR180, 3D, HDR, Location, Purchased."
},
"language": {
"type": "string",
"title": "Language",
"default": "en",
"maxLength": 10,
"description": "Language code for localized results (for example en)."
},
"location": {
"type": "string",
"title": "Location",
"default": "US",
"maxLength": 10,
"description": "Country code for localized results (for example US)."
},
"upload_date": {
"anyOf": [
{
"type": "string",
"maxLength": 128
},
{
"type": "null"
}
],
"title": "Upload Date",
"default": null,
"description": "Upload date filter. One of: Last hour, Today, This week, This month, This year."
},
"content_type": {
"anyOf": [
{
"type": "string",
"maxLength": 128
},
{
"type": "null"
}
],
"title": "Content Type",
"default": null,
"description": "Content type filter. One of: Video, Channel, Playlist, Movie."
}
}
}Parent server
Vee3
https://github.com/Vee3io/Vee3
1/7 registries