Virtual Buy Box on Similar Products

Kaufland groups your product with closely comparable products from other sellers. These are separate products, not offers on the same product page, so there is no real Buy Box between them. But shoppers who come across them in search treat them as interchangeable and usually take the cheapest one, so in practice they compete like a Buy Box does. This endpoint ranks up to 10 products in that group the same way, so you get the whole picture in one call instead of checking product by product. Each entry has the same shape as a single GET /buybox response.

Endpoint

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

Parameter Required Description
id_product Either id_product or ean Kaufland's product ID of one of your products. We return the group of similar products this product belongs to.
ean Either id_product or ean The EAN of one of your products. Use it instead of id_product.
storefront Yes The storefront you want the ranking for (e.g. de for Kaufland.de).
condition No Which offer condition to return, same as GET /buybox. Defaults to new.

If the product has no similar products yet, the response is { "data": [] }. This is not an error.

Sample response

{
    "data": [
        {
            "id_product": 8475634,
            "storefront": "cz",
            "condition": "new",
            "num_units": 1,
            "units": [
                {
                    "buybox_rank": 1,
                    "seller": "Kaufland Seller",
                    "price": 1999,
                    "delivery_time_min": 3,
                    "delivery_time_max": 4,
                    "shipping_rate": 700,
                    "fulfillment_type": "fulfilled_by_merchant",
                    "condition": "NEW",
                    "id_unit": 28374940,
                    "id_offer": "SKU1342"
                }
            ]
        }
    ]
}

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

Response fields

  • id_product: Integer — Our internal product ID.
  • storefront: String — Storefront the ranking applies to.
  • condition: String — The condition the offers were filtered by (the resolved value, not necessarily the group condition passed in the request).
  • num_units: Integer — Total number of offers for the given product and condition.
  • units: Array — The ranked list of offers, see below.

Unit fields

  • buybox_rank: Integer — Rank of this offer in the Buybox (1 is the winning offer).
  • seller: String — Name of the competing seller.
  • price: Integer — Offer price, in minor units of the storefront's currency.
  • delivery_time_min: Integer — Minimum delivery time in days.
  • delivery_time_max: Integer — Maximum delivery time in days.
  • shipping_rate: Integer — Shipping cost, in minor units of the storefront's currency.
  • fulfillment_type: String — One of fulfilled_by_merchant or fulfilled_by_kaufland.
  • condition: String — The exact condition of the unit, using the same condition values as inventory units (e.g. NEW, USED___GOOD).
  • id_unit: Integer or absent — Internal unit ID. Only present when you are the owner of the unit.
  • id_offer: String, null, or absent — Your own unique ID for the offer. Only present when you are the owner of the unit.

Error responses

The following errors may be returned:

  • 400 Bad Request — the request parameters have invalid values (e.g. malformed id_product/ean/storefront, or neither id_product nor ean was provided).
  • 404 Not Found — the given id_product does not match any product.