Frequently Bought Together

Introduction

Frequently Bought Together is a product recommendation model that is commonly used by eCommerce and marketplace sites to help users find products that go along with the item they're looking at. It's usually presented as a ribbon on the product details page (PDP), often in addition to a You May Also Like recommendation. Frequently Bought Together helps keep users engaged and ensures that they don't need to take an extra step to search for nails when they are about to buy a hammer.

Miso supports Frequently Bought Together recommendations through the special buy_together parameter on the Product to Products API. When this parameter is not set, the API will tend to suggest alternatives to the current product (as with You May Also Like). Using buy_together tells Miso to return suggestions that are likely to be purchased in addition to the current product, based on user behavior on your site and Miso's semantic understanding of the contents of your products. To drive conversions, the suggested products will also be personalized to the user's interests.

Before You Start

API Call / JSON Response

To fetch Frequently Bought Together recommendations, POST to the Product to Products API with the following parameters:

• user_id: The user or anonymous visitor to personalize the recommendations for
• product_id: The anchor product
• buy_together: Set this parameter to true, which tells Miso to return products that are frequently bought together

The API will return a list of recommended products.

Example API Call

POST /v1/recommendation/product_to_products?api_key=<API_KEY> HTTP/1.1
{
    "user_id": "user-123",
    "buy_together": true,
    "product_id": "women-r1-fleece"
}

Example JSON Response

{
    "message": "success",
    "data": {
        "took": 52,
        "miso_id": "a4606bf0-ddd3-11eb-ba80-0242ac130004",
        "products": [
            {
                "product_id": "women-nano-puff",
                "title": "Women's Nano Puff Jackets",
                "price": 149,
                ..., // Additional scoring information
            },
            {
                "product_id": "women-ahnya-pants",
                "title": "Women's Ahnya Fleece Pants",
                "price": 79,
                ..., // Additional scoring information
            },
            ...
        ]
    }
}

Read more about the scoring information that Miso returns in the API response.

Before You Launch