---
title: "Brands whose public Shopify catalog changed most over the last `days` days: `launches` ranks by products first seen in the catalog (after the store's first complete scan), `price_cuts` and `price_raises` by variants whose listed price fell or rose. Each row carries every count and up to 5 samples of the ranked kind. Built every 6 hours over the last 35 days."
method: GET
path: "/v1/rankings/store-changes"
tags: ["rankings"]
---

# Brands whose public Shopify catalog changed most over the last \`days\` days: \`launches\` ranks by products first seen in the catalog (after the store's first complete scan), \`price_cuts\` and \`price_raises\` by variants whose listed price fell or rose. Each row carries every count and up to 5 samples of the ranked kind. Built every 6 hours over the last 35 days.

`GET /v1/rankings/store-changes`

## Request

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

Brands whose public Shopify catalog changed most over the last `days` days: `launches` ranks by products first seen in the catalog (after the store's first complete scan), `price_cuts` and `price_raises` by variants whose listed price fell or rose. Each row carries every count and up to 5 samples of the ranked kind. Built every 6 hours over the last 35 days. Scope `rankings:read`; cache `hourly`.

## Query parameters

- `kind` 'launches' | 'price_cuts' | 'price_raises'
- `days` integer
- `category_id` string, uuid
- `brand_ids` string
- `limit` integer

## Response `200`

Success.

- object
  - `data` object[], required
    - `brand` object, required
      - `id` string, uuid, required
      - `slug` string, required
      - `name` string, required
      - `logo_url` string, uri, nullable, required
      - `url` string, uri, required
    - `first_day` string, date, required
    - `last_day` string, date, required
    - `first_seen` integer, required
    - `price_cuts` integer, required
    - `price_raises` integer, required
    - `products_moved` integer, required
    - `samples` object[], required
      - `product_id` string, required
      - `title` string, required
      - `url` string, required
      - `image_url` string, nullable, required
      - `before` string, nullable, required
      - `after` string, nullable, 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.

## Changes

- **2026-10-19** `4d67a114a13c`: 1 info
  - added the new optional `query` request parameter `brand_ids`

[Operation history](https://skmtc.dev/scrollstash/apis/storequant-api/changes/v1/rankings/store-changes/get.md)

---

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