---
title: "categories.concentration's daily series for many categories of one level in one read (no share of voice or movers): HHI of active-ad shares, the top four brands' share, Gini, live brands, active and new ads per day over the last `days` days, oldest first. Every category asked is answered, in the order asked; `days: []` means no built day."
method: GET
path: "/v1/category-concentration"
tags: ["categories"]
---

# categories.concentration's daily series for many categories of one level in one read (no share of voice or movers): HHI of active-ad shares, the top four brands' share, Gini, live brands, active and new ads per day over the last \`days\` days, oldest first. Every category asked is answered, in the order asked; \`days: \[\]\` means no built day.

`GET /v1/category-concentration`

## Request

- Base URL: `https://api.storequant.com`
- URL: `https://api.storequant.com/v1/category-concentration`
- Auth: HTTP bearer

categories.concentration's daily series for many categories of one level in one read (no share of voice or movers): HHI of active-ad shares, the top four brands' share, Gini, live brands, active and new ads per day over the last `days` days, oldest first. Every category asked is answered, in the order asked; `days: []` means no built day. Scope `categories:read`; cache `daily`.

## Query parameters

- `categories` string, required
- `level` 'top_level' | 'category' | 'subcategory'
- `days` integer

## Response `200`

Success.

- object
  - `data` object[], required
    - `category_id` string, uuid, required
    - `days` object[], required
      - `date` string, date, required
      - `hhi` number, required
      - `cr4` number, required
      - `gini` number, required
      - `live_brands` integer, required
      - `active_ads` integer, required
      - `new_ads` integer, required
  - `meta` object, required
    - `request_id` string, required
    - `as_of` string, date-time, required
    - `lag_hours` number
    - `cursor` string
    - `count` integer

## Other responses

- `4XX`: The one error shape.
- `5XX`: The one error shape.

---

[API](https://skmtc.dev/scrollstash/apis/storequant-api.md) · [All operations](https://skmtc.dev/scrollstash/apis/storequant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrollstash/apis/storequant-api/revisions/4fbe9d681caf?raw)