# Video

> Source: https://docs.recombee.com/logics/video

> For the complete documentation index, see [llms.txt](/llms.txt).

# Video

Set of fine-tuned Video logics, specifically designed for VOD and similar use cases.

## video:continue-watching

Model ensemble suitable for recommending partially watched movies or episodes, or the next episode from a watched series.

See the [Scenario Recipe](https://docs.recombee.com/recipes/video/fully-personalized-homepage/continue-watching) guide for more information.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Recommend Items to User](/api/recommendations#request-recommend-items-to-user)

---

### Parameters

watchingStartedPercentage

Integer

Default: **10**

Percentage of an asset length for it to be considered as being watched.

---

watchingCompletedPercentage

Integer

Default: **90**

Percentage of an asset length for it to be considered as completely watched.

---

assetType

Enum

Default: **movies+episodes**

Allowed Values: **movies |** **episodes |** **movies+episodes** 

Asset type to be recommended.

## video:personal

Model ensemble suitable for recommending personalized rows on the homepage or browse pages.

Rows with specific content (e.g. award-winning movies) can be set up by applying filters.

See the [Scenario Recipe](https://docs.recombee.com/recipes/video/fully-personalized-homepage/recommended-for-you-rows) guide for more information.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Recommend Items to User](/api/recommendations#request-recommend-items-to-user)·

[Recommend Items to Item Segment](/api/recommendations#request-recommend-items-to-item-segment)

---

### Parameters

assetType

Enum

Default: **movies+episodes**

Allowed Values: **movies |** **episodes |** **series |** **movies+episodes |** **movies+series** 

Asset type to be recommended.

---

excludeAlreadyWatched

Boolean

Default: **true**

Exclude already watched assets.

## video:segments-for-you

Model ensemble suitable for recommending favorite segments (genres, actors, ...) for a specific user.

A particular segmentation must exist beforehand.

See the [Scenario Recipe](https://docs.recombee.com/recipes/video/fully-personalized-homepage/actors-for-you) guide for more information.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Recommend Item Segments to User](/api/recommendations#request-recommend-item-segments-to-user)

## video:popular

Model ensemble suitable for recommending globally popular items.

See the [Scenario Recipe](https://docs.recombee.com/recipes/video/fully-personalized-homepage/popular-and-trending) guide for more information.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Recommend Items to User](/api/recommendations#request-recommend-items-to-user)·

[Recommend Items to Item Segment](/api/recommendations#request-recommend-items-to-item-segment)

---

### Parameters

timePeriod

Duration

Default: **14d** 

The time period in which the popularity is measured.

---

userSegmentFilter

String

Default: **true**

[ReQL filter](https://docs.recombee.com/reql_filtering_and_boosting#reql-filtering) on top of user properties defining the segment of users among whom the popularity is calculated. For example, when user properties like `profession` and `country` are provided for some users, you may only ask for items popular among software developers in US and Canada: `'profession'=="software developer" and 'country' in {"US", "CA"}`.

---

assetType

Enum

Default: **movies+episodes**

Allowed Values: **movies |** **episodes |** **series |** **movies+episodes |** **movies+series** 

Asset type to be recommended.

---

excludeAlreadyWatched

Boolean

Default: **false**

Exclude already watched assets.

## video:editors-picks

Model ensemble suitable for recommendations of hand-picked editorial content.

See the [Scenario Recipe](https://docs.recombee.com/recipes/video/fully-personalized-homepage/editors-picks-for-you) guide for more information.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Recommend Items to User](/api/recommendations#request-recommend-items-to-user)

---

### Parameters

picks

Item IDs Array

Default: **\[\]**

List of items to be recommended.

---

excludeAlreadyWatched

Boolean

Default: **false**

Exclude already watched assets.

---

personalizedReordering

Boolean

Default: **true**

Reorder picked assets in a personalized way for the user.

## video:more-like-this

Model ensemble suitable for recommending similar assets on the asset detail page.

See the [Scenario Recipe](https://docs.recombee.com/recipes/video/asset-detail-and-player/more-like-this) guide for more information.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Recommend Items to Item](/api/recommendations#request-recommend-items-to-item)

---

### Parameters

assetType

Enum

Default: **movies+episodes**

Allowed Values: **movies |** **episodes |** **series |** **movies+episodes |** **movies+series** 

Asset type to be recommended.

---

excludeAlreadyWatched

Boolean

Default: **false**

Exclude already watched assets.

## video:watch-next

Model ensemble suitable for end-of-playback recommendations embedded in a video player.

See the [Scenario Recipe](https://docs.recombee.com/recipes/video/asset-detail-and-player/watch-next) guide for more information.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Recommend Items to Item](/api/recommendations#request-recommend-items-to-item)

---

### Parameters

assetType

Enum

Default: **movies+episodes**

Allowed Values: **episodes |** **movies |** **series |** **movies+episodes |** **movies+series** 

Asset type to be recommended.

---

excludeAlreadyWatched

Boolean

Default: **false**

Exclude already watched assets.

## video:episodes-list

Model ensemble suitable for reverse-chronological listing episodes of a particular series.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Recommend Items to Item](/api/recommendations#request-recommend-items-to-item)

---

### Parameters

excludeAlreadyWatched

Boolean

Default: **false**

Exclude already watched assets.

## video:search

Smart personalized full-text search suitable for searching movies, series, and episodes.

See the [Scenario Recipe](https://docs.recombee.com/recipes/video/search-movies-and-series) guide for more information.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Search Items](/api/search#request-search-items)

---

### Parameters

assetType

Enum

Default: **movies+episodes**

Allowed Values: **movies |** **episodes |** **series |** **movies+episodes |** **movies+series** 

Asset type to be recommended.

---

personalizationImpact

Enum

Default: **medium**

Allowed Values: **low |** **medium |** **high** 

Determines whether personalization or full-text should have a higher priority in the ranking of the items.

## video:search-segments

Smart personalized full-text search suitable for searching segments (genres, actors, ...).

A particular segmentation must exist beforehand.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Search Item Segments](/api/search#request-search-item-segments)

## video:emailing

Model ensemble suitable for sending personalized emails with personalized content for the user. It contains fine-tuned rotation settings so that the set of recommended assets for a particular user changes with each e-mail sent.

See the [Scenario Recipe](https://docs.recombee.com/recipes/video/search-movies-and-series) guide for more information.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Recommend Items to User](/api/recommendations#request-recommend-items-to-user)

---

### Parameters

assetType

Enum

Default: **movies+episodes**

Allowed Values: **movies |** **episodes |** **series |** **movies+episodes |** **movies+series** 

Asset type to be recommended.

---

rotationPolicy

Enum

Default: **smart**

Allowed Values: **smart |** **total** 

A policy determining how strictly should already recommended items be rotated.

The default option "smart" contains fine-tuned rotation settings, which take into account the position of recommended items and enable some of the items to re-appear in further e-mails.

Option "total" never recommends items that have already appeared in previous e-mails.

## video:videos-from-top-genre-for-you

This Composite Logic delivers a comprehensive recommendation in a single response consisting of:

* **Top Genre for the User**: It identifies and returns the most relevant genre or category for the user, based on their viewing history and preferences.
* **Top Videos from the Genre**: Along with the top genre, it also returns a list of the top videos within that genre or category.

This Logic is ideal for recommending both a genre and its associated videos together, making it particularly useful for personalized sections on the homepages of video streaming platforms.

If you wish to display multiple rows for distinct top genres in a personalized order, you can achieve this by making multiple Composite Recommendation requests within a single Batch call.

It is expected that the Item Segmentation selected in the configuration represents the genres or categories of the videos.

See the [Scenario Recipe](https://docs.recombee.com/recipes/video/fully-personalized-homepage/personalized-re-ordering-of-rows-advanced) guide for more information.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Composite Recommendation](/api/recommendations#composite-recommendation)

---

### Composite Stages

For

Recommendation

Source

Result

User

Item Segment

Items

Source

Endpoint:   **Item Segments to User**

The Logic returns the most relevant genre for the user.

---

Result

Endpoint:   **Items to Item Segment**

The Logic returns the list of the top items within the top genre.

## video:videos-from-top-segment-for-you

This Composite Logic delivers a comprehensive recommendation in a single response consisting of:

* **Top Segment for the User**: It identifies and returns the most relevant Segment for the user. Depending on the selected Item Segmentation, this could be a Director, Theme, Tag, Actor, etc.
* **Top Videos from the Segment**: Along with the top Segment, it also returns a list of the top videos associated with that Segment.

Based on the selected Item Segmentation, this Logic can be used for rows such as “Your Favorite Director … And Their Movies” or “Videos About Your Favorite Topic …”.

If you wish to display multiple rows for distinct top Segments in a personalized order, you can achieve this by making multiple Composite Recommendation requests within a single Batch call.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Composite Recommendation](/api/recommendations#composite-recommendation)

---

### Composite Stages

For

Recommendation

Source

Result

User

Item Segment

Items

Source

Endpoint:   **Item Segments to User**

The Logic returns the most relevant Item Segment (e.g., the top Director, Theme, Tag, Actor, etc) for the user from the specified Segmentation.

---

Result

Endpoint:   **Items to Item Segment**

The Logic returns the list of the top videos within the top Segment.

## video:because-you-watched

This Composite Logic delivers personalized recommendations based on a user's previous watching activity, all within a single response consisting of:

* **Video the User Watched**: It selects and returns a video that the user has recently watched.
* **Top Related Videos**: Along with the watched video, it also returns a list of top videos related to that specific video, offering content the user is likely to be interested in.

This Logic is ideal for scenarios like “Because You Watched …,” where recommendations are tailored to the user’s recent watching history.

The watched video is determined based on View Portion interactions, and you can refine this by specifying the maxDaysAgo and minWatchedPercentage parameters to define which View Portions are considered. If no such View Portion exists, an empty recommendation is returned.

If you want to display multiple sets of related videos based on different watched content, you can achieve this by making multiple Composite Recommendation requests within a single Batch call.

See the [Scenario Recipe](https://docs.recombee.com/recipes/video/fully-personalized-homepage/because-you-watched) guide for more information.

_This Logic is not available in new databases by default. Please contact [support@recombee.com](mailto:support@recombee.com) if you want to use it._

---

Applicable to endpoints

[Composite Recommendation](/api/recommendations#composite-recommendation)

---

### Composite Stages

For

Recommendation

Source

Result

User

Item

Items

Source

Endpoint:   **Items to User**

The Logic selects and returns a video that the user has recently watched.

#### Parameters

maxDaysAgo

Integer

Default: **30**

Defines the maximum number of days since the user watched a video for it to be considered for the "Because" selection.

For example, setting maxDaysAgo to 7 will only consider videos watched within the last 7 days.

---

minWatchedPercentage

Integer

Default: **75**

Defines the minimum portion of a video that must be watched, based on the View Portion interaction, for it to be considered watched by the user (e.g. 75% by default).

This ensures that only videos where the user has engaged with at least the specified portion are included in the "Because" selection.

---

Result

Endpoint:   **Items to Item**

The Logic returns a list of top videos related to a specific video, offering content the user is likely to be interested in.