Video filters

Filters are used to refine your search results when working with the video object. This page provides the complete list of supported video filters.


FieldsDescription
360_degreeLimit the result set to 360 videos.
advertising_instream_blockedLimit the result set to advertising_instream_blocked
allowed_in_playlistsLimit the results to videos which are allowed in playlists.
availabilityLimit the result set to available videos.
channelLimit the result set to this channel.
countryLimit the result set to this country (declarative).
created_afterLimit the result set to videos created after this date and time.
created_beforeLimit the result set to videos created before this date and time.
exclude_channel_idsList of channels ids to exclude from the result set.
exclude_idsList of video ids to exclude from the result set.
explicitLimit the result set to the provided explicit value for videos.
exportableLimit the result set to exportable (i.e: no-export flag not set) videos.
featuredLimit the result set to featured videos.
flagsList of simple boolean flags available to reduce the result set.
has_gameLimit the result set to videos related to a video-game.
hdLimit the result set to high definition videos (vertical resolution greater than or equal to 720p).
idsLimit the result set to this list of video identifiers (works only with xids).
in_historyLimit the result set to videos in your watch history.
is_created_for_kidsLimit the result set to the provided is_created_for_kids value for videos.
languagesLimit the result set to this list of languages.
listLimit the result set to this video list. Warning: Can not be combined with a search.
liveLimit the result set to live streaming videos.
live_offairLimit the result set to off-air live streaming videos.
live_onairLimit the result set to on-air live streaming videos.
live_upcomingLimit the result set to upcoming live streaming videos.
longer_thanLimit the results to videos with a duration longer than or equal to the specified number of minutes.
modeLimit the result set to videos of this mode.
no_liveLimit the result set to non-live streaming videos.
no_live_recordingLimit the result set to live recording videos.
no_premiumLimit the result set to free video content.
nogenreLimit the result set by excluding this genre.
ownersLimit the result set to this list of user identifiers or logins.
partnerLimit the result set to partner videos.
password_protectedLimit the result set to password protected partner videos.
premiumLimit the result set to premium SVOD and TVOD video content.
privateLimit the result set to private videos.
related_videos_algorithmForces the recommendation result to use a specifc algorithm
searchLimit the result set to this full text search.
shorter_thanLimit the results to videos with a duration shorter than or equal to the specified number of minutes.
sortChange the default result set ordering.
timeframeLimit the result set to videos created after this N last seconds.
ugcLimit the result set to user generated video content (no partner content).
ugc_partnerLimit the result set to user generated or partner video content.
unpublishedLimit the result set to unpublished videos.
verifiedLimit the result set to verified partner videos.








created_after

Limit the result set to videos after this date and time.

TypeSample value
date1287507036



created_before

Limit the result set to videos created before this date and time.

TypeSample value
date1287507036