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.
Successful searches use 20 API tokens. Failed or blocked requests are not billed.