---
title: "One chain: basket position, strongest categories, branches by city"
method: GET
path: "/v1/insights/chains/{slug}"
---

# One chain: basket position, strongest categories, branches by city

`GET /v1/insights/chains/{slug}`

## Request

- Base URL: `https://supermcp.co.il`
- URL: `https://supermcp.co.il/v1/insights/chains/{slug}`
- Auth: none required

## Path parameters

- `slug` string, required

## Response `200`

OK

- object
  - `data` object
    - `chainId` string
    - `slug` string
    - `name` string
    - `nameEn` string
    - `branchCount` integer: Physical branches in the catalogue. NOT branches we hold prices for; there are none.
    - `cityCount` integer
    - `pricedProducts` integer
    - `basketIndex` integer, nullable: Standard-basket total as a percentage of the market median. 100 is average. Null unless the chain stocks every line of the basket, and the median is taken over those chains only, so both sides of the fraction are real prices for the same list.
    - `freshness` object, nullable: When the price list behind a figure was published, and whether that is now stale.
      - `asOf` string, date: Israel local date.
      - `stale` boolean: Older than the 7-day staleness limit.
    - `cities` object[]
      - `city` string
      - `branchCount` integer
    - `basket` object[]
      - `slug` string
      - `price` number, nullable
      - `marketMedian` number, nullable
      - `name` string, nullable
    - `strongCategories` object[]: Where this chain sits furthest below the market, compared product by product.
      - `slug` string
      - `l2` string
      - `deltaPercent` number: Negative is cheaper than the market.

## Other responses

- `400`: Bad request. Query parameters are validated strictly: a parameter this document does not list is rejected, and `details[].keys` names it. A misspelled filter used to be dropped silently, which answered a question nobody asked with a plausible list of products.
- `401`: Unauthorized
- `404`: Not found
- `429`: Rate limited

---

[API](https://skmtc.dev/supermcp/apis/super-mcp-api.md) · [All operations](https://skmtc.dev/supermcp/apis/super-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/supermcp/apis/super-mcp-api/revisions/f0dea9415b1c?raw)