---
title: "Rising in ads this week: brands (or categories) whose observed launches in the 7 days up to the build day run above the mean of the three weeks before, weighted by how many of their recent ads survived a week. Only reliably covered brands are ranked. Differs from rankings.risers, which ranks growth in active ads. Observed launches and observed survival, not performance or spend. Answers 409 until the view's first nightly build."
method: GET
path: "/v1/rankings/ad-risers"
tags: ["rankings"]
---

# Rising in ads this week: brands (or categories) whose observed launches in the 7 days up to the build day run above the mean of the three weeks before, weighted by how many of their recent ads survived a week. Only reliably covered brands are ranked. Differs from rankings.risers, which ranks growth in active ads. Observed launches and observed survival, not performance or spend. Answers 409 until the view's first nightly build.

`GET /v1/rankings/ad-risers`

## Request

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

Rising in ads this week: brands (or categories) whose observed launches in the 7 days up to the build day run above the mean of the three weeks before, weighted by how many of their recent ads survived a week. Only reliably covered brands are ranked. Differs from rankings.risers, which ranks growth in active ads. Observed launches and observed survival, not performance or spend. Answers 409 until the view's first nightly build. Scope `rankings:read`; cache `daily`.

## Query parameters

- `scope` 'brand' | 'category_top' | 'category'
- `category_id` string, uuid
- `limit` integer

## Response `200`

Success.

- object
  - `data` object, required
    - `as_of` string, date, required
    - `week_start` string, date, required
    - `week_end` string, date, required
    - `scope` 'brand' | 'category_top' | 'category', required
    - `basis` 'observed launches by Meta's start date among reliably covered brands; survival is observed survival, not performance or 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.
    - `risers` object[], required
      - `rank` integer, required
      - `brand` object, nullable, required
        - `id` string, uuid, required
        - `slug` string, required
        - `name` string, required
        - `logo_url` string, uri, nullable, required
        - `url` string, uri, required
      - `category` object, nullable, required
        - `id` string, uuid, required
        - `name` string, nullable, required
      - `new_ads_7d` integer, required
      - `prior_3w_mean` number, required
      - `lift` number, required
      - `survival_weight` number, required
      - `survival_n` integer, required
      - `score` number, required
      - `reliable_days_7d` integer, required
      - `reliable_days_prior_21d` integer, required
      - `brands` 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/c556e643d689?raw)