---
title: "The distribution of brand metrics over every public brand, a market or a category: brands counted and the 25th, 50th, 75th, 90th and 95th percentiles. Metrics: launches_per_day_7d (new ads in the last 7 days / 7; Proven's churn gate compares a brand with its `all` p95) and the benchmark metrics (launch_velocity, survival_median_days, kill_rate_14d, refresh_rate, format_*_share, whitelisting_share). Derived from the nightly build."
method: GET
path: "/v1/rankings/index-percentiles"
tags: ["rankings"]
---

# The distribution of brand metrics over every public brand, a market or a category: brands counted and the 25th, 50th, 75th, 90th and 95th percentiles. Metrics: launches_per_day_7d (new ads in the last 7 days / 7; Proven's churn gate compares a brand with its \`all\` p95) and the benchmark metrics (launch_velocity, survival_median_days, kill_rate_14d, refresh_rate, format_\*_share, whitelisting_share). Derived from the nightly build.

`GET /v1/rankings/index-percentiles`

## Request

- Base URL: `https://api.storequant.com`
- URL: `https://api.storequant.com/v1/rankings/index-percentiles`
- Auth: HTTP bearer

The distribution of brand metrics over every public brand, a market or a category: brands counted and the 25th, 50th, 75th, 90th and 95th percentiles. Metrics: launches_per_day_7d (new ads in the last 7 days / 7; Proven's churn gate compares a brand with its `all` p95) and the benchmark metrics (launch_velocity, survival_median_days, kill_rate_14d, refresh_rate, format_*_share, whitelisting_share). Derived from the nightly build. Scope `rankings:read`; cache `daily`.

## Query parameters

- `scope` 'all' | 'market' | 'category'
- `scope_id` string, uuid
- `metric` string

## Response `200`

Success.

- object
  - `data` object[], required
    - `metric` string, required
    - `scope` 'all' | 'market' | 'category', required
    - `scope_id` string, nullable, required
    - `n` integer, required
    - `p25` number, required
    - `p50` number, required
    - `p75` number, required
    - `p90` number, required
    - `p95` number, required
    - `as_of` string, date, 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/4d67a114a13c?raw)