YouTube search
Search YouTube for videos and other content with optional pagination.
← All YouTube endpoints · Capability overview
/v1/youtube/searchhttps://api.vee3.io/v1/youtube/search
Search YouTube for videos and other content with optional pagination.
Authorization
Send your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
MCP
The same capability is available as an MCP tool on Vee3 hosted MCP.
Tool name
search_youtubeParameters9 fields
querystringRequiredSearch keywords or phrase.
max length 512
cursorstringOptionalPagination cursor from cursorNext.
max length 4096
languagestringOptionalLanguage code for localized results (for example en).
Default: "en" · max length 10
locationstringOptionalCountry code for localized results (for example US).
Default: "US" · max length 10
upload_datestringOptionalUpload date filter. One of: Last hour, Today, This week, This month, This year.
max length 128
content_typestringOptionalContent type filter. One of: Video, Channel, Playlist, Movie.
max length 128
durationstringOptionalDuration filter. One of: Under 4 minutes, 4 - 20 minutes, Over 20 minutes.
max length 128
featuresarrayOptionalFeature filters. Multiple allowed. Each value must be one of: Live, 4K, HD, Subtitles/CC, Creative Commons, 360°, VR180, 3D, HDR, Location, Purchased.
max 6
sort_bystringOptionalSort order. One of: Relevance, Upload date, View count, Rating.
max length 128
Response22 fields
contentsarrayitems18 fieldsSearch result entries for the current page. Video entries include a type field and nested video object.
contentsarrayitemstypestringResult entry type (for example video).
videoobject16 fieldsVideo payload when type is video.
videoobjectvideoIdstringVideo id.
titlestringVideo title.
lengthSecondsintegerVideo duration in seconds.
publishedTimeTextstringHuman-readable publish age.
isLiveNowbooleanWhether the video is live.
authorobject4 fieldsVideo author summary (avatar omitted).
authorobjecttitlestringChannel or creator display name.
badgesarrayitems2 fieldsAuthor badges (for example Official Artist Channel).
badgesarrayitemstextstringBadge label.
typestringBadge type code.
statsobject1 fieldView counts for the video.
statsobjectviewsintegerView count.
thumbnailsarrayitems3 fieldsThumbnail images for the video.
thumbnailsarrayitemsurlstringThumbnail image URL.
widthintegerThumbnail width in pixels.
heightintegerThumbnail height in pixels.
cursorNextstringCursor for the next results page, when available.
estimatedResultsintegerApproximate total number of matching results.
didYouMeanstringSuggested corrected query when the search may be misspelled.
HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_not_configured, youtube_upstream_error, youtube_search_filter_not_found