# Video Selection Guide

## Video parameter filters

\
Here is the complete list of parameters you can use to filter videos, with these you can create your own recipe to select the videos that best work for you:

* **Id**: integer value that identifies the video.
* **Title**.
* **Type**: includes:
  * Trailer
  * Scene or Clip
  * Behind the Scenes
  * Interview
* **StartDate**: first date of video availability
* **ExpirationDate**: most videos include this datetime, expired videos don't play.
* **Mature**: boolean, indicates if a video is designated content not suitable for children. Age gate required.
* **CaptionID**: integer that indicates the identifier of a closed caption if exists.
* **Duration**: indicates the length of the video, for example, trailers are usually longer than 1 minute.
* **Language**: string value that indicates language spoken.
* **LanguageSubtitled**: string value that indicates language subtitled.
* **Company**: name of the company.
* **Clean**: video with no release date info.
* **AllowAdvertising**: boolean, indicates if video ads are allowed in front of of content
* **Certification**: boolean, indicates if the video is certified.
* **Theatrical**: boolean, indicates if the video is promoting theatrical release.
* **HomeVideo**: boolean, indicates if the video is promoting home video release.
* **SourceVideoWidth**: width of the source video in pixels. This value can be compared against the video's height to determine the overall orientation (e.g., identifying "vertical" format videos where the height is greater than the width).
* **SourceVideoHeight**: height in pixels.
* **Encoded**: datetime, indicates when it was encoded.
* **ScreenCaptures**: list of screen captures.
* **TargetCountries**: two letter iso code that indicates the country video is targeted for.
* **TargetLanguage**: string that indicates the targeted language the video is for.

*Note: In order to get the video data, you have to use the Entertainment API with the Search endpoint and add the Includes = videos parameter.*

## How to select the best video

\
We know that sometimes it is hard to select the best video because there are a lot! So here are some suggestions to display the best trailer in English:

1. Use language spoken = English, language subtitled = null. If the language spoken does not = English, then use language subtitled = English.
2. Show the most recent video using the most recent encoded date.
3. Use video with the video length = above 60 seconds.
4. Use a trailer where Clean = True when available. If not, then ignore to find ones with attributes listed above.

This will get you the most recent English trailer, no TV spots, and if there is a clean version, one with no release date info.

Remember you can create your own recipe, one that fits your needs, this are only suggestions.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledgebase.fabricdata.com/origin/video-selection-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.