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_id 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.

Limit the result set to this category.

Sample values: news auto animals

See all video categories.

Limit the result set to this country (declarative, may be null). Allowed values are ISO 3166-1 alpha-2 country codes.

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

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

List of categories to exclude from the result set.

Sample values: news auto animals

List of video ids to exclude from the result set.

List of simple boolean flags available to reduce the result set.

See allowed values.

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

Limit the result set to this video list.
Warning: Can not be combined with a search.

Allowed values: what-to-watch or recommended

Limit the result set to videos of this mode.

Allowed values: vod or live

Limit the result set by excluding this genre.
Min length: 1
Max length: 150

Limit the result set to this list of user identifiers or logins.
Min length: 1
Max length: 150

Forces the recommendation result to use a specific algorithm.
Min length: 1
Max length: 150

Allowed values: uploader-only, uploader-with-siblings, uploader-with-parent or uploader-with-children

Limit the result set to this full text search.
Min length: 1
Max length: 150

Change the default result set ordering.

Allowed 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