--- title: "Live Intent" slug: "recommendation-api-live-intent-algorithm" description: "Documents the GET /v2/user-engagement endpoint, using a transformer model on the user's last 10 product views in 7 days for real-time recommendations." tags: ["buy to buy"] updated: 2026-11-10T08:31:04Z published: 2026-11-10T08:31:04Z canonical: "academy.insiderone.com/recommendation-api-live-intent-algorithm" --- > ## Documentation Index > Fetch the complete documentation index at: https://academy.insiderone.com/llms.txt > Use this file to discover all available pages before exploring further. # Live Intent > [!NOTE] > **Note**: As of November 10, 2026, Real-Time User Engagement is now called Live Intent. The Live Intent algorithm recommends products by analyzing the current user’s most recent interactions. It generates personalized recommendations based on real-time behaviors and evolving preferences. The Live Intent algorithm tailors product recommendations based on the user’s most recent product-view activity, using a deep-learning transformer model that dynamically adapts to recent interactions, such as viewing or purchasing patterns. It focuses specifically on items the user has shown interest in during recent sessions. During a Recommendation API request to the user-engagement endpoint, the UCD profile endpoint is called to retrieve the last 10 products the user visited in the past 7 days. To receive Live Intent recommendations, the user must have at least one product visit in the last 7 days. If there have been no visits in that period, fallback recommendation results will be displayed instead. ## Endpoint > **GET** https://recommendation.api.useinsider.com/v2/user-engagement[](https://developers.insiderone.com/#40cc53de-e43d-4e64-b097-be4527529fa7) > Visit our Postman collection to test this request. ## Query Parameters | Parameter | Sample Value | Description | Data Type | Required | | --- | --- | --- | --- | --- | | partnerName | mybrand | Partner Identifier assigned by Insider One. You can use PartnerID as well. | String | Yes | | locale | us_US | Locale of the requested product catalog | String | Yes | | platform | web | Requested platform. Web comes by default. | Enum | No | | userId | a1b2c3d4 | User identifier that is assigned by Insider One | String | Yes | | currency | USD | Requested currency of the products. If no value is set, the default currency in your settings is used. | String | No | | size | 50 | Required number of items in response. Valid values are 0 to 100. | Integer | No | | categoryList | [“Clothes”, “Skirts”] | Category filter of the products | Array (of string) | No | | filter | | [Smart Recommender filtering](https://academy.insiderone.com/docs/filtering-recommendation-responses). There can be more than one filter parameter. | String | No | | details | true | Adds details to the products in the response | Boolean | No | | shuffle | false | Shuffles the products of the response | Boolean | No | | getGroupProducts | false | Determines if the products within the same **groupcode** should be returned in the recommendation response | Boolean | No | | groupProductsFields | | Defines the fields that should be returned for the products in the **group_products** section. If requested group product fields are missing from a product, that product won't appear in the **group_products** section. | String | No | | excludeVariants | true | Exclude variants from the response. The default value is false. Valid values are 1, 0, *true*, and *false*. | Boolean | No | | excludeViewDay | 30 | After how many days should viewed products be excluded | Integer | No (Can be used only with userId) | | excludeViewItem | 100 | How many viewed products should be excluded | Integer | No (Can be used only with userId) | | excludePurchaseDay | 30 | After how many days should purchased products be excluded | Integer | No (Can be used only with userId) | | excludePurchaseItem | 100 | How many purchased products should be excluded | Integer | No (Can be used only with userId) | | hp | false | Makes affinities affect products of the response. The default is *false*. | Boolean | No | | dayLimit | 2 | If FMT is published_time, it adds a day limit filter. The default is 2. | Integer | No | | productId | ABC123CBA | Current product ID | String | No | ## Sample Request The sample below displays a request to Live Intent, a personalized recommendation algorithm that analyzes the current user’s most recent interactions (such as product views, clicks, or cart actions) to deliver highly relevant product suggestions in real time. ```http https://recommendation.api.useinsider.com/v2/user-engagement?locale={locale}&userId={userId}&partnerName={partnerName} ``` ## Sample Response ```json {        "success": true,        "total": 10,        "types": {        "ue": 10        },        "data": [        "649517_49890",        "568334_49053",        "639714_49677",        "651579_3255",        "614493_50094",        "614508_49668",        "568334_47380",        "641331_49914",        "621390_3255",        "646581_48990"        ]        } ``` ## Fallback Algorithms If the current user has not visited two or more products, or if Live Intent recommendations are filtered out, recommendations from the following algorithms are returned in sequence: - [Purchased Together](/docs/purchased-together-algorithm) - [Most Popular Items](/docs/most-popular-items-algorithm) ## Related - [API Authentication Tokens](/api-authentication-tokens.md) - [API Rate Limits](/api-rate-limits.md) - [API Status and Error Codes](/api-status-and-error-codes.md) - [Insider One APIs in Postman](/insider-apis-in-postman.md)