Similar Product Groups

This endpoint is for the same sellers as GET /similar-products/buybox — sellers whose products compete with very similar products from other sellers rather than with identical ones, typically own-brand (private label) products, and for repricers and technology partners. Use this endpoint to see all your groups of similar products at once and decide where to act first.

Kaufland groups each of your products with closely comparable products from other sellers, items where shoppers decide mainly on price. This endpoint returns those groups for one storefront. For every group you get your own price position and sales position, how far your customer price is from the best offer in the group, and the competing offers ranked using the same calculation as the Seller Portal. Ranking considers the voucher-discounted price, shipping cost, and delivery time; the price gap compares the voucher-discounted price plus shipping. Use it to see where you are already competitive and where a price change would move you up.

What a group of similar products is

Many products compete for the customer's attention without sharing an EAN, so they never meet in the same Buy Box. A customer looking for a 10-metre garden hose compares a handful of very similar hoses from different sellers and usually picks the cheapest one that fits. Kaufland uses an AI-based process to find these very similar products and puts them into a group of similar products. Most products in such groups are own brands, but a product that also has a regular Buy Box can be part of a group. The grouping is automated and not perfect: sellers can remove or add competitors in the Seller Portal (Pricing Optimisation → Private label products), and those adjustments are reflected in this endpoint.

How this relates to /similar-products/buybox

• GET /similar-products/buybox is the competitor list for one product, in the /buybox shape.
• GET /similar-products/groups (this endpoint) is every group you are in, with your position, the gap, the demand and the recommendation.

How to use the result

Related

• GET /similar-products/buybox
• Seller Portal: Pricing Optimisation → Private label products

Endpoint

HTTP method: GET
URL: https://sellerapi.kaufland.com/v2/similar-products/groups
Query parameters:

If none of your products are in a group of similar products yet, the response is { "data": [] }. This is not an error.

Sample response

{
    "data": [
        {
            "group_id": "a1b2c3",
            "storefront": "de",
            "currency": "EUR",
            "group_demand": "high",
            "own_price_rank": 1,
            "own_sales_rank": 1,
            "own_share": "high",
            "gap_to_best_price": 149,
            "number_of_competitors": 4,
            "easy_win": true,
            "recommendation": "focus",
            "ladder": [
                {
                    "price_rank": 1,
                    "seller": "Example Seller GmbH",
                    "id_product": 123456789,
                    "product_name": "Example product",
                    "ean": "1234567890123",
                    "price": 1999,
                    "shipping_cost": 299,
                    "delivery_time_min": 1,
                    "delivery_time_max": 3,
                    "ratings_count": 128,
                    "average_rating": 4.5,
                    "manufacturer_name": "Example Manufacturer",
                    "voucher": null,
                    "is_excluded": false,
                    "is_own_offer": false
                }
            ]
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 20,
        "total": 4
    }
}

The complete response schema, including all field types, is available in the endpoint specification.

Response Fields

Group fields

Ladder entry fields

Voucher fields