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
Visit our Postman collection to test this request.
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.