---
title: "Categories with enough comparable products to rank"
method: GET
path: "/v1/insights/categories"
---

# Categories with enough comparable products to rank

`GET /v1/insights/categories`

## Request

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

Class keys, not display names. Fresh produce is absent by necessity: loose fruit and vegetables carry chain-local item codes rather than barcodes, so nothing cross-chain can be said about them.

## Response `200`

OK

- object
  - `data` object
    - `categories` object[]
      - `slug` string
      - `l1` string
      - `l2` string
      - `productCount` integer
      - `topRatio` number

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