Universal Models

Universal Recombee models for the most common use-cases.

Default model ensemble aiming to work well in most common use cases. It is an ensemble of collaborative filtering and content-based recommendation, backed by popularity-based models when there's not enough data in the given context. The ensemble is being continuously optimized by AI so it automatically adapts to incoming data.


Universal model ensemble suitable for putting recommendations on the homepage / welcome-screen scenarios.


Universal model ensemble suitable for user-based recommendations reflecting the personal tastes of the current user.



There must be interaction data for the user.

Universal model ensemble suitable for either recommending items which are similar to the given item (in case of Items-to-Item recommendation), or recommending users who are similar to the given user (in case of Users-to-User recommendation).


Universal model suitable for recommending globally popular items, taking into account all interaction types. More important actions (purchases, cart-additions) have higher weight for computing the popularity than less important actions (detail-views).



Interaction data (Detail Views/Purchases/Cart Additions) must be present.




Universal model ensemble suitable for recommending globally popular segments.





Model returning the list of recently viewed items for a particular user.



Detail Views must exist for the user.


Duration
Default: 14d

Maximal age of the DetailView since the current timestamp.


Enum
Default: descending
Allowed Values: ascending | descending

Order in which the items are returned with regard to the time when they were interacted. When the order is descending, the last interacted item is at the beginning of the list of recommendations. When it is ascending, the first interacted item matching the maxAge condition is at the beginning of the list.

Model recommending similar items based on visual similarity (using deep-learning neural networks to process the images provided through the image properties). While the image similarity can take part in other Logics as well, in recombee:visually-similar, it is explicitly used as the primary model. Image processing may take some time. Therefore, changes in image item properties do not take effect in real-time. The functionality is still in beta mode.

This Logic is not available in new databases by default. Please contact support@recombee.com if you want to use it.



Some image properties must be defined for items, with valid image links provided for the majority of the items in the catalog.


Boolean
Default: false

Enable fallback models to make the recommendations if the model based on visual similarity cannot be used (e.g. due to a missing image for the given source item).

Model recommending similar items based on item properties (numerical values, sets, and texts). While property values can take part in other Logics, in recombee:similar-properties, they are explicitly used as the primary data source for recommending similar items or uses. Various machine-learning methods, including NLP deep-learning networks that process unstructured text descriptions, are used to compute the similarities.



Some properties must exist for the items/users, depending on the used API endpoint.


Boolean
Default: false

Enable fallback models to make recommendations if the model based on item properties cannot be used (e.g. due to missing property values for the given source item).

Model ensemble suitable for recommending items in periodic e-mailing campaigns. It contains fine-tuned rotation settings so that the set of recommended items for a particular user changes with each e-mail sent.

By default, rotation only takes into account recommendations (e-mails) at most 14 days old. Should a longer time period be needed for your use case, kindly contact support@recombee.com.



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.

Model suitable for recommending items ordered by a ReQL expression given as a booster


Recommends items that are contextually related to the Item Segment and should be of interest to the user. Items may belong to the Segment or be outside it if they are strongly relevant.

Consider using recombee:personal-from-segment if you want recommendations strictly limited to items within the Segment.

Examples:

  • News: For the "Climate Change" Segment, recommend articles about renewable energy (inside the Segment) or related topics like electric vehicles (outside the Segment).
  • Music: For the "Jazz" Segment, recommend jazz-related songs, including classic tracks (inside the Segment) or modern experimental pieces (outside the Segment).
  • E-commerce: For the "Digital Cameras" Segment, recommend products like digital cameras (inside the Segment) or accessories like tripods, lenses, or lighting kits (outside the Segment).
  • Video Streaming: For the "Science Fiction" Segment, recommend sci-fi movies (inside the Segment) or related dystopian thrillers (outside the Segment).

Recommends items from the Item Segment, tailored to the user's preferences.

Consider using recombee:related-to-segment if you don't need all the recommended items to belong to the Segment.

Examples:

  • News: For the "Environmental News" Segment, recommend articles on climate policy or renewable energy that align with the user’s reading history.
  • Music: For the "Jazz" Segment, recommend jazz songs matching the user’s listening habits.
  • E-commerce: For the "Digital Cameras" Segment, recommend digital cameras the user is most likely to be interested in, based on their browsing and purchase history.
  • Video Streaming: For the "Science Fiction" Segment, recommend sci-fi movies that match the user’s preferences.

Recommends the most popular items within the Item Segment, based on overall engagement. Use this Logic to highlight trending or widely appealing items.

Examples:

  • News: Most-read articles from the "World Politics" Segment.
  • Music: Most-streamed tracks from the "Rock" Segment.
  • E-commerce: Best-selling smartphones in the "Smartphones" Segment.
  • Video Streaming: Most-watched action movies in the "Action Movies" Segment.


Interaction data (Detail Views/Purchases/Cart Additions) must be present.



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

  • Top Segment for the User: It identifies and returns the most relevant Item Segment (e.g., the top category) for the user from the specified Segmentation.
  • Top Items from the Segment: Along with the Segment, it also returns a list of the top items within that Segment.

This Logic is ideal for recommending a section and its content together, making it particularly useful for personalized homepage sections.

If you want to display multiple distinct sections in a personalized order on your homepage, you can achieve this by making multiple Composite Recommendation requests within a single Batch call.

For more specific use cases, such as "Videos From The Top Genre For You" or "Products from the Top Category For You," there are specialized Logics available.



For
Recommendation
Source
Result
User
Item Segment
Items

Endpoint: Item Segments to User

The Logic returns the most relevant Item Segment (e.g., the top category) for the user from the specified Segmentation.


Endpoint: Items to Item Segment

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

This Composite Logic delivers two results within a single response consisting of:

  • Item the User Interacted With: The Logic selects and returns an item that the user has interacted with, based on the interaction types specified by the interactionTypes parameter (e.g., Watched, Purchased, Liked).
  • Top Related Items: Simultaneously, it returns a list of top items related to that specific interacted item.

This Logic is ideal for general "Because You..." scenarios, where recommendations are tailored based on the user's previous interactions. For more specific use cases, such as "Because You Bought" or "Because You Watched", there are specialized Logics available.



For
Recommendation
Source
Result
User
Item
Items

Endpoint: Items to User

The Logic selects and returns an item that the user has recently interacted with.

Enum Set
Default: [bookmarks, cartAdditions, detailViews, purchases, ratings, viewPortions]
Allowed Values: bookmarks | cartAdditions | detailViews | purchases | ratings | viewPortions

Defines which interactions are considered when selecting the item the user has interacted with


Integer
Default: 30

Defines the maximum number of days since the user interacted the item for it to be considered for the "Because" selection.

For example, setting maxDaysAgo to 7 will only consider items interacted within the last 7 days.


Endpoint: Items to Item

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

This Logic is designed for infinite swiping feed experiences (such as reels or short-form video feeds), where users continuously browse content and can express feedback through likes or dislikes.

It optimizes recommendations in real time based on a configurable combination of user engagement (likes, number of viewed items, purchases), and time spent consuming content.



View Portions shall be sent for consumed content, with the autoPresented parameter set to true and timeSpent specified

Likes and dislikes shall be sent as +1 / -1 Ratings

After a few items have been presented, call Recommend Next Items to retrieve the next batch of content


Property
Default: None

Property representing the creation time of an item, enabling the Logic to evaluate and prioritize newer content in recommendations.


Double
Default: 0

Weight (0–1) controlling the importance of time spent on content in the optimization.


Double
Default: 0

Weight (0–1) controlling the importance of user likes (positive Ratings) in the optimization.


Double
Default: 0

Weight (0–1) controlling the importance of maximizing the number of items consumed by the user.


Double
Default: 0

Weight (0–1) controlling the importance of Purchases in the optimization.

© Copyright 2026, Recombee s.r.o
docs.recombee.com