---
title: "A brand against its category on eight observed measures: launch velocity (new ads a day), median observed survival, 14-day kill rate, refresh rate, video, image and carousel share of active ads, and whitelisting share. Each with the brand's value, the ads it rests on (n), the category's median and quartiles, the brand's percentile and a confidence level. Counts of observed ads and observed survival; never spend. Answers 409 until the view's first nightly build."
method: GET
path: "/v1/brands/{brandId}/benchmark"
tags: ["brands"]
---

# A brand against its category on eight observed measures: launch velocity (new ads a day), median observed survival, 14-day kill rate, refresh rate, video, image and carousel share of active ads, and whitelisting share. Each with the brand's value, the ads it rests on (n), the category's median and quartiles, the brand's percentile and a confidence level. Counts of observed ads and observed survival; never spend. Answers 409 until the view's first nightly build.

`GET /v1/brands/{brandId}/benchmark`

## Request

- Base URL: `https://api.storequant.com`
- URL: `https://api.storequant.com/v1/brands/{brandId}/benchmark`
- Auth: HTTP bearer

A brand against its category on eight observed measures: launch velocity (new ads a day), median observed survival, 14-day kill rate, refresh rate, video, image and carousel share of active ads, and whitelisting share. Each with the brand's value, the ads it rests on (n), the category's median and quartiles, the brand's percentile and a confidence level. Counts of observed ads and observed survival; never spend. Answers 409 until the view's first nightly build. Scope `brands:read`; cache `daily`.

## Path parameters

- `brandId` union, required
  - string, uuid
  - string

## Response `200`

Success.

- object
  - `data` object, required
    - `as_of` string, date, required
    - `category` object, nullable, required
      - `id` string, uuid, required
      - `name` string, nullable, required
    - `basis` 'counts of observed ads and observed survival against the brand's category; never spend', required: A note for readers. What each number is (observed, derived or estimate) is in the op's claims: `x-claims` in the OpenAPI document.
    - `metrics` object[], required
      - `metric` 'launch_velocity' | 'survival_median_days' | 'kill_rate_14d' | 'refresh_rate' | 'format_video_share' | 'format_image_share' | 'format_carousel_share' | 'whitelisting_share', required
      - `brand_value` number, required
      - `brand_shrunk_value` number, required
      - `n` integer, required
      - `category_value` number, required
      - `category_p25` number, required
      - `category_p75` number, required
      - `category_n` integer, required
      - `percentile` number, required
      - `confidence` 'high' | 'medium' | 'low', 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/c556e643d689?raw)