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",
			"brand": "Joe Nimble",
			"category": "Fashion & accessoires",
			"category_2": "Shoes & accessories",
			"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",
			"brand": null,
			"category": "Auto & Motorrad",
			"category_2": null,
			"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.
  • brand - string|nullable
    The brand of the product.
  • category - string|nullable
    The product's category on Kaufland.
  • category_2 - string|nullable
    The product's sub-category on Kaufland.
  • buybox_price_l_90_day - integer|nullable
    Average Buy Box price over the last 90 days (integer in cents, i.e. 1/100 of the currency unit, e.g., 1716 = 17.16 EUR).
  • buybox_price_l_60_day - integer|nullable
    Average Buy Box price over the last 60 days (integer in cents, i.e. 1/100 of the currency unit, e.g., 1724 = 17.24 EUR).
  • buybox_price_l_30_day - integer|nullable
    Average Buy Box price over the last 30 days (integer in cents, i.e. 1/100 of the currency unit, e.g., 1696 = 16.96 EUR).
  • buybox_price_current - integer|nullable
    The current real-time Buy Box price (integer in cents, i.e. 1/100 of the currency unit, e.g., 1556 = 15.56 EUR).
  • 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. The ranking is calculated within the product's category on those external platforms, so it can differ from the Kaufland categories shown in category and category_2.
  • external_demand_indicator - string|nullable
    A measure of the product's demand outside of Kaufland, derived from external bestseller data. The demand is judged against other products in the product's category on those external platforms, so it can differ from the Kaufland categories shown in category and category_2.
    Possible values: Very low, Low, Medium, High, Very high, No data (no external data available for this product)
  • 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.
  • By default, the API returns 10 items per request. However, users can adjust this limit to retrieve a desired number of items, with a maximum limit of 5000 items per request.
  • total - The total items.