---
title: "TikTok Shop shops (US) ranked over 1, 7 or 30 days by the shop's own units sold or by its GMV estimate. GMV is an estimate with its band, never revenue; every row says what history it rests on. Answers 409 until the view's first nightly build."
method: GET
path: "/v1/rankings/tiktok-shop/shops"
tags: ["rankings"]
---

# TikTok Shop shops (US) ranked over 1, 7 or 30 days by the shop's own units sold or by its GMV estimate. GMV is an estimate with its band, never revenue; every row says what history it rests on. Answers 409 until the view's first nightly build.

`GET /v1/rankings/tiktok-shop/shops`

## Request

- Base URL: `https://api.storequant.com`
- URL: `https://api.storequant.com/v1/rankings/tiktok-shop/shops`
- Auth: HTTP bearer

TikTok Shop shops (US) ranked over 1, 7 or 30 days by the shop's own units sold or by its GMV estimate. GMV is an estimate with its band, never revenue; every row says what history it rests on. Answers 409 until the view's first nightly build. Scope `rankings:read`; cache `daily`.

## Query parameters

- `period` '1d' | '7d' | '30d'
- `rank_kind` 'units' | 'gmv'
- `limit` integer

## Response `200`

Success.

- object
  - `data` object, required
    - `as_of` string, date, required
    - `market` 'US', required
    - `currency` 'USD', required
    - `gmv_is_estimate` true, required
    - `method` 'GMV is an estimate: units sold (the change in TikTok's public units-sold counter, which excludes returned items) priced from the listings on the day. It is a band, not revenue; Seller Center GMV includes returns and runs higher.', required
    - `period` '1d' | '7d' | '30d', required
    - `rank_kind` 'units' | 'gmv', required
    - `shops` object[], required
      - `rank` integer, required
      - `seller_id` string, required
      - `shop_name` string, required
      - `units` integer, required
      - `units_prior` integer, nullable, required
      - `growth` number, nullable, required
      - `gmv_estimate` number, nullable, required
      - `gmv_estimate_low` number, nullable, required
      - `gmv_estimate_high` number, nullable, required
      - `days_read` integer, required
      - `history_days` integer, required
      - `coverage` 'full_period' | 'partial_period' | 'under_7_days_history', 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)