Chef is an automated recommendation algorithm that automatically brings the best-mixed strategy combination by testing the most popular items, top sellers, user-based, highest discounted, new arrivals, and trending items algorithms for better conversion rates. In a mixed strategy, you manually choose an algorithm for each slot. Chef, instead, chooses the best combination by evaluating the performance of the algorithms automatically.
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. 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 | Yes |
| userId | testUser | User ID | String | No |
| hp | false, true or 0, 1 | Makes affinities affect 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 displays 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 needed.
GET https://recommendation.api.useinsider.com/v2/chef?partnerName={PartnerName}&locale={Locale}¤cy={Currency}
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, the fallback algorithms are determined by the individual algorithms chosen by the Chef.