Chef is an automated recommendation algorithm that automatically identifies the best mixed strategy by testing the most popular items, top sellers, user-based, highest-discounted, new arrivals, and trending items algorithms to improve conversion rates. In a mixed strategy, you manually choose an algorithm for each slot. Chef, instead, chooses the best combination by automatically evaluating the algorithms' performance.
Endpoint
GET https://recommendation.api.useinsider.com/v2/chef
Query Parameters
Parameter | Sample Value | Description | Data Type | Required |
|---|---|---|---|---|
partnerName | mybrand | Partner Identifier, which is assigned by Insider One. You can use PartnerID as well. | String | Yes |
locale | us_US | Language or region of the site. | String | Yes |
platform | web | It is the requested platform. Its value can be web and app. Web comes by default. | Enum | No |
currency | USD | Shows products with the specified currency. | String | No |
userId | testUser | User identifier, which is assigned by Insider One. | String | No |
hp | false, true or 0, 1 | Makes affinities affect the products of the response. The default is false. | Boolean | No |
categoryList | ["Tops","Shirts"] | Category filter of the products | ||
filter | Smart Recommender filtering. There can be more than one filter parameter. | String | No | |
details | true | Adds details to the products of the response. | Boolean | No |
shuffle | false | Shuffles the products of the response. | Boolean | No |
getGroupProducts | true | Shows variant products under the products of the response. | Boolean | No |
groupProductsFields | Adds these fields to the variant products’ details. | String | No | |
excludeVariants | true | Exclude variants from the response. | Boolean | No |
excludeViewDay | 30 | After how many days viewed products should be excluded. The default is -1. | Integer | No (Can only be used with userId) |
excludeViewItem | 10 | How many viewed products should be excluded. The default is -1. | Integer | No (Can only be used with userId) |
excludePurchaseDay | 30 | After how many days purchased products should be excluded. The default is -1. | Integer | No (Can only be used with userId) |
excludePurchaseItem | 10 | How many purchased products should be excluded. The default is -1. | Integer | No (Can only be used with userId) |
country | Italy | Requested country information | String | No (Only for Location Based Top Sellers usage in Mixed Strategy) |
city | Milan | Requested city information | String | No (Only for Location Based Top Sellers usage in Mixed Strategy) |
dayLimit | 7 | Threshold last update day value for Publisher partners The default is 2 days. | Integer | No |
ulv | true, false | Enables User Last Visit to affect recommendation results | Boolean | No |
Sample Request
The sample below shows a request to Chef, an automated recommendation strategy that picks the best-performing mix (popular items, top sellers, user-based, highest-discounted, new arrivals, trending, etc.) per slot—no manual algorithm selection required.
https://recommendation.api.useinsider.com/v2/chef?partnerName={PartnerName}&locale={Locale}Sample Response
{
"success": true,
"total": 16,
"types": {
"mpop": 14,
"mvop": 2
},
"data": [
"ABC1234",
"ABC1243",
"ABC1234",
"ABC1235",
"ABC1237",
"ABC1230",
"ABC1263",
"ABC1209",
"ABC1256",
"CBA1234",
"CBA1233",
"CBA1236",
"CBA1239",
"CBA1221",
"CBA1209",
"CBA1247"
]
}Fallback Algorithms
The Chef algorithm doesn't have a specific fallback mechanism; instead, fallback algorithms are determined by the individual algorithms selected by Chef.