- 07 Feb 2024
- 1 Minute to read
Purchased Together
- Updated on 07 Feb 2024
- 1 Minute to read
Overview
This algorithm recommends items by finding complementary products purchased by other users with the products purchased by the user. It generates recommendations based on the products purchased in the same sessions and the same locale during the past 30 days. After generating recommendations, the algorithm orders the results according to their purchase frequency. With this algorithm, you can apply the purchase patterns of your users to your strategies. This type of algorithm works best on product and cart pages.
Endpoint
GET https://recommendation.api.useinsider.com/v2/purchased-together
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 | Locale of requested product catalog. | String | Yes |
platform | web | Requested platform. Web comes by default. | Enum | No |
currency | USD | Requested currency of the products. If no value is set, the default currency in your settings is used. | String | Yes |
productId | ABC1234 | The id of the product whose complementary is requested. | String | Yes |
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. 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 | false | 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 response. | Boolean | No |
Sample Example
Sample Request
GET https://recommendation.api.useinsider.com/v2/purchased-together?partnerName={PartnerName}&locale={Locale}&productId={ProductId}¤cy={Currency}
Sample Response
{
"success": true,
"total": 10,
"types": {
"btb": 10
},
"data": [
"QAZ-7890",
"XYZ-1234",
"QAZ-7899",
"XYZ-1233",
"QAZ-7898",
"XYZ-1243",
"QAZ-7891",
"XYZ-1223",
"QAZ-7892",
"XYZ-1342"
]
}
Fallback Algorithms
If the products come from Purchased Together are not enough to fill the response data, some fallback algorithms below fill it:
- View Together
- Most Purchased of Category
- Most Purchased of Partner