Assortment Insight

The Assortment Insight API endpoint provides assortment and pricing insights. This endpoint allows users to access key metrics, including Buy Box prices across different periods, sales rank information, and external demand indicators.

Endpoint

HTTP Method: GET
URL: https://sellerapi.kaufland.com/v2/assortment-coverage/insights

Response Details

The API returns a JSON object that includes product data in an array along with pagination details.

Sample Response

Response body:

{
	"data": [
		{
			"ean": "04062784153675",
			"item_name": "Joe Nimble Trail Addict WR",
			"category": "Mode & Accessoires",
			"buybox_price_l_90_day": 1716,
			"buybox_price_l_60_day": 1724,
			"buybox_price_l_30_day": 1696,
			"buybox_price_current": 1556,
			"sales_rank": 61217,
			"external_rank": 12815,
			"external_demand_indicator": "Low",
			"benchmark_price_min": 1500,
			"benchmark_price_max": 1800,
			"external_bestseller_missed": false,
			"popular_product_bad_priced": true,
			"kaufland_bestseller": false,
			"currency": "EUR"
		},
		{
			"ean": "04067896931531",
			"item_name": "HJC Helm C10 Epik",
			"category": "Auto & Motorrad",
			"buybox_price_l_90_day": null,
			"buybox_price_l_60_day": null,
			"buybox_price_l_30_day": null,
			"buybox_price_current": null,
			"sales_rank": null,
			"external_rank": 6291,
			"external_demand_indicator": "Very low",
			"benchmark_price_min": null,
			"benchmark_price_max": null,
			"external_bestseller_missed": true,
			"popular_product_bad_priced": false,
			"kaufland_bestseller": true,
			"currency": "EUR"
		}
	],
	"pagination": {
		"offset": 100,
		"limit": 2,
		"total": 318562
	}
}

Explanation of Fields

Response Format: JSON
Each response is a JSON object with the following data types as defined in the API model:

  • data - An array containing the product details.
    • ean - string
      The unique 13-digit product barcode.
    • item_name - string|nullable
      The name or title of the product.
    • category - string|nullable
      The product's category on Kaufland.
    • buybox_price_l_90_day - integer|nullable
      Average Buy Box price over the last 90 days (in the smallest currency unit, e.g., 1716 = 17.16 in local currency).
    • buybox_price_l_60_day - integer|nullable
      Average Buy Box price over the last 60 days (in the smallest currency unit, e.g., 1724 = 17.24 in local currency).
    • buybox_price_l_30_day - integer|nullable
      Average Buy Box price over the last 30 days (in the smallest currency unit, e.g., 1696 = 16.96 in local currency).
    • buybox_price_current - integer|nullable
      The current real-time Buy Box price (in the smallest currency unit, e.g., 1556 = 15.56 in local currency).
    • sales_rank - integer|nullable
      The product's sales ranking on Kaufland.
    • external_rank - integer|nullable
      The product's sales ranking on platforms outside of Kaufland.
    • external_demand_indicator - string|nullable
      A measure of the product's demand outside of Kaufland.
      Possible values: Very low, Low, Medium, High, Very high
    • benchmark_price_min - integer|nullable
      The minimum external benchmark price for this product (in the smallest currency unit).
    • benchmark_price_max - integer|nullable
      The maximum external benchmark price for this product (in the smallest currency unit).
    • external_bestseller_missed - boolean
      Indicates if an external bestseller is not available on Kaufland.
    • popular_product_bad_priced - boolean
      Flags popular products that are not priced competitively on Kaufland.
    • kaufland_bestseller - boolean
      Identifies top-selling products within their category on Kaufland.
    • currency - string
      The currency code for the prices in the object. Currently only supports EUR.
  • pagination - Contains details regarding the pagination of the response.
    • offset - The starting index for the returned results.
    • limit - The number of items returned per page.
    • total - The total items.