Purchased Together
  • 07 Feb 2024
  • 1 Minute to read

    Purchased Together


      Article Summary

      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

      Your title goes here
      When this algorithm is used on the cart page, its endpoint differs for multiple products. For example; there are 3 products (X, Y, Z) in the cart. The recommendation API will return the complementary products for each product in the cart as X1, Y1, Z1, X2, Y2, Z2... respectively.

      Query Parameters

      ParameterSample ValueDescriptionData TypeRequired
      partnerNamemybrandPartner Identifier which is assigned by Insider. You can use PartnerID as well.StringYes
      localeus_USLocale of requested product catalog.StringYes
      platformwebRequested platform. Web comes by default.EnumNo
      currencyUSDRequested currency of the products. If no value is set, the default currency in your settings is used.StringYes
      productId
      ABC1234The id of the product whose complementary is requested.
      StringYes
      size50Required number of items in response. Valid values are 0 to 100.IntegerNo
      categoryList[“Clothes”, “Skirts”]Category filter of the productsArray (of string)No
      filter
      Smart Recommender filtering. There can be more than one filter parameter.StringNo
      detailstrueAdds details to the products of the response.BooleanNo
      shufflefalseShuffles the products of the response.BooleanNo
      getGroupProductsfalseShows variant products under the products of the response.BooleanNo
      groupProductsFields
      Adds these fields to the variant products’ details.StringNo
      excludeVariantstrueExclude variants from response.BooleanNo

      Sample Example

      Sample Request

      GET https://recommendation.api.useinsider.com/v2/purchased-together?partnerName={PartnerName}&locale={Locale}&productId={ProductId}&currency={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

      Was this article helpful?

      ESC

      Eddy, a super-smart generative AI, opening up ways to have tailored queries and responses