---
title: "One category, widest price gap first"
method: GET
path: "/v1/insights/categories/{slug}"
---

# One category, widest price gap first

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

## Request

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

## Path parameters

- `slug` string, required

## Response `200`

OK

- object
  - `data` object
    - `slug` string
    - `l1` string
    - `l2` string
    - `productCount` integer
    - `topRatio` number
    - `products` object[]
      - `gtin` string
      - `name` string
      - `slug` string: URL segment: Hebrew words then the barcode.
      - `brand` string, nullable
      - `categorySlug` string, nullable
      - `chainCount` integer
      - `min` number
      - `max` number
      - `ratio` number
    - `commoditySlugs` string[]

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