search
Search YouTube videos, playlists, channels, or all content types using filters for duration, features, upload date, and sorting options.
Instructions
Search videos, playlists, channels, or all of them. Quota cost is 2 units.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search term | |
| token | No | Pagination token Alternatively, use X-TOKEN in header | |
| geo | No | ISO 3166-2 country code of the region. Like US (default), GB, CA, IN, etc. | |
| lang | No | Locale/language for request. Like en, gb, hi, etc | |
| type | No | Search type filter options: video channel playlist movie show shorts Sorting is not available in shorts | |
| duration | No | Duration filter options: short - less than 4 min medium - 4 to 20 min long - more than 20 min | |
| features | No | Video Features options: HD subtitles CCommons 3D Live Purchased 4K 360 Location HDR VR180 Multiple features could be joined by ',' For example: HD,subtitles | |
| upload_date | No | Upload Date filter options: hour today week month year | |
| sort_by | No | Results Sort options: relevance [default] rating date views | |
| local | No | Get localized data, the value must be 1. Works with provided value of geo, if not provided then default is US. Quota Cost +1 | |
| X-CACHEBYPASS | No | Cache bypass, the value must be 1 Quota Cost +1 | |
| X-TOKEN | No | Alternative way to pass Pagination token via headers. This will solve 414, URI too long issue. |