Filters are used to refine your search results when working with the video object. This page provides the complete list of supported video filters.
| Fields | Description |
|---|---|
360_degree | Limit the result set to 360 videos. |
advertising_instream_blocked | Limit the result set to advertising_instream_blocked |
allowed_in_playlists | Limit the results to videos which are allowed in playlists. |
availability | Limit the result set to available videos. |
channel | Limit the result set to this channel. |
country | Limit the result set to this country (declarative). |
created_after | Limit the result set to videos created after this date and time. |
created_before | Limit the result set to videos created before this date and time. |
exclude_channel_ids | List of channels ids to exclude from the result set. |
exclude_ids | List of video ids to exclude from the result set. |
explicit | Limit the result set to the provided explicit value for videos. |
exportable | Limit the result set to exportable (i.e: no-export flag not set) videos. |
featured | Limit the result set to featured videos. |
flags | List of simple boolean flags available to reduce the result set. |
has_game | Limit the result set to videos related to a video-game. |
hd | Limit the result set to high definition videos (vertical resolution greater than or equal to 720p). |
ids | Limit the result set to this list of video identifiers (works only with xids). |
in_history | Limit the result set to videos in your watch history. |
is_created_for_kids | Limit the result set to the provided is_created_for_kids value for videos. |
languages | Limit the result set to this list of languages. |
list | Limit the result set to this video list. Warning: Can not be combined with a search. |
live | Limit the result set to live streaming videos. |
live_offair | Limit the result set to off-air live streaming videos. |
live_onair | Limit the result set to on-air live streaming videos. |
live_upcoming | Limit the result set to upcoming live streaming videos. |
longer_than | Limit the results to videos with a duration longer than or equal to the specified number of minutes. |
mode | Limit the result set to videos of this mode. |
no_live | Limit the result set to non-live streaming videos. |
no_live_recording | Limit the result set to live recording videos. |
no_premium | Limit the result set to free video content. |
nogenre | Limit the result set by excluding this genre. |
owners | Limit the result set to this list of user identifiers or logins. |
partner | Limit the result set to partner videos. |
password_protected | Limit the result set to password protected partner videos. |
premium | Limit the result set to premium SVOD and TVOD video content. |
private | Limit the result set to private videos. |
related_videos_algorithm | Forces the recommendation result to use a specifc algorithm |
search | Limit the result set to this full text search. |
shorter_than | Limit the results to videos with a duration shorter than or equal to the specified number of minutes. |
sort | Change the default result set ordering. |
timeframe | Limit the result set to videos created after this N last seconds. |
ugc | Limit the result set to user generated video content (no partner content). |
ugc_partner | Limit the result set to user generated or partner video content. |
unpublished | Limit the result set to unpublished videos. |
verified | Limit the result set to verified partner videos. |
created_after
created_afterLimit the result set to videos after this date and time.
| Type | Sample value |
|---|---|
| date | 1287507036 |
created_before
created_beforeLimit the result set to videos created before this date and time.
| Type | Sample value |
|---|---|
| date | 1287507036 |
