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.