GET/v1/chains/{chain}/zones

Chain price zones

A chain's shops grouped by the prices of the chain's newest complete import day; the zones are computed once a day, after the import (a partial crawl keeps the previous day's zones). A shop is compared on the basket items it lists with a readable regular price (the price without a sale): it joins the first zone with the same price on every item both list that shares at least half of the shop's prices, otherwise it starts a zone. An item one of them does not list is not a difference; one differing price is. The basket is the items at least half of that day's shops list. Shops with fewer than 20 basket prices are in unassigned; shops whose newest list is older than that day (by up to 30 days) are in left_out. A zone's id is the lowest source id among its shops and holds for that day. The chain is the part of the source id before the dot. From the Business plan.

ParameterInRequiredDescription
chainpathyese.g. konzum-hr
curl "https://price.download/v1/chains/konzum-hr/zones" \
  -H "Authorization: Bearer $PD_KEY"
●Response
{
  "chain": "konzum-hr",
  "date": "2026-11-12",
  "shops": 4,
  "basket_items": 8412,
  "zones": [
    { "zone": "konzum-hr.0185", "sources": ["konzum-hr.0185", "konzum-hr.0417"] },
    { "zone": "konzum-hr.0606", "sources": ["konzum-hr.0606"] }
  ],
  "unassigned": ["konzum-hr.0733"],
  "left_out": [
    { "source": "konzum-hr.0912", "last_list_date": "2026-11-10" }
  ]
}