---
title: "Every chain, ranked on the same standard basket"
method: GET
path: "/v1/insights/chains"
---

# Every chain, ranked on the same standard basket

`GET /v1/insights/chains`

## Request

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

## Response `200`

OK

- object
  - `data` object
    - `chains` 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.

## 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)