List videos

List of fields to return.

To add several fields, separate each value with a comma (i.e. title,description)

Sample of possible values: title description id channel content_provider country created_time duration embed_html embed_url geoblocking is_created_for_kids language mode private private_id publish_date published url

See the exhaustive list of possible values and their description.

Filter -

Limit the result set to this category.

Possible values: animals auto creation fun kids lifestyle music news people school shortfilms sport tech travel tv videogames webcam

See all video categories.

Filter - Limit the result set to videos created after this date and time.
Timestamp sample value: 1287507036

Filter - Limit the result set to videos created before this date and time.
Timestamp sample value:1287507036

Limit the result set to this list of video identifiers (works only with xIDs).

Limit the result set to this list of languages. Language is declarative and corresponds to the user-declared spoken language of the video. If you wish to retrieve content curated for a specific locale, use the localization global parameter instead.
Sample values: ["fr","en","it"]

Limit the results to videos with a duration longer than or equal to the specified number of minutes.
Sample value: 3600

Limit the result set to videos of this mode.
Possible values: vodor live

Limit the result set to this full text search.
Sample value: football

Change the default result set ordering.
Notes: The relevance filter can only be used in conjunction with the search filter.
Possible values: recent visited visited-hour visited-today visited-week visited-month relevance random trending old live-audience least-visited live-airing-time or id-asc

Limit the result set to this full text search of video tags. By default perform 'AND' operation between terms. Use enclosing parenthesis '()' on the query to perform 'OR' operation.
Sample value: ["party","John Doe"]