---
title: "The brand's TikTok Shop sales (US), from TikTok's public units-sold counters read daily: per linked shop, units sold per UTC day (exact, from the shop's own counter) and a GMV ESTIMATE as a low-high band from the prices listed that day, with the top tracked products. Never revenue: the counter excludes returned items and the page shows today's prices. History starts at the first read. A brand with no linked shop, or one not yet read on two days, answers status not_collected, never zero sales."
method: GET
path: "/v1/brands/{brandId}/tiktok-shop"
tags: ["brands"]
---

# The brand's TikTok Shop sales (US), from TikTok's public units-sold counters read daily: per linked shop, units sold per UTC day (exact, from the shop's own counter) and a GMV ESTIMATE as a low-high band from the prices listed that day, with the top tracked products. Never revenue: the counter excludes returned items and the page shows today's prices. History starts at the first read. A brand with no linked shop, or one not yet read on two days, answers status not_collected, never zero sales.

`GET /v1/brands/{brandId}/tiktok-shop`

## Request

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

The brand's TikTok Shop sales (US), from TikTok's public units-sold counters read daily: per linked shop, units sold per UTC day (exact, from the shop's own counter) and a GMV ESTIMATE as a low-high band from the prices listed that day, with the top tracked products. Never revenue: the counter excludes returned items and the page shows today's prices. History starts at the first read. A brand with no linked shop, or one not yet read on two days, answers status not_collected, never zero sales. Scope `brands:read`; cache `daily`.

## Path parameters

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

## Query parameters

- `days` integer
- `max_products` integer

## Response `200`

Success.

- object
  - `data` union, required
    - object
      - `status` 'collected', required
      - `brand_id` string, uuid, required
      - `market` 'US', required
      - `currency` 'USD', required
      - `gmv_is_estimate` true, required
      - `method` string, required
      - `from` string, date, required
      - `to` string, date, required
      - `units` integer, required
      - `gmv_low` number, nullable, required
      - `gmv_high` number, nullable, required
      - `shops` object[], required
        - `seller_id` string, required
        - `shop_name` string, required
        - `shop_url` string, required
        - `linked_by` string, required
        - `lifetime_units` integer, nullable, required
        - `lifetime_units_at` string, date-time, nullable, required
        - `units` integer, required
        - `gmv_low` number, nullable, required
        - `gmv_high` number, nullable, required
        - `tracked_share` number, nullable, required
        - `days` object[], required
          - `day` string, date, required
          - `units` integer, required
          - `gmv_low` number, nullable, required
          - `gmv_high` number, nullable, required
          - `tracked_units` integer, required
          - `interval_start` string, date-time, required
          - `interval_end` string, date-time, required
        - `products` object[], required
          - `product_id` string, required
          - `title` string, required
          - `url` string, required
          - `price_low` number, nullable, required
          - `price_high` number, nullable, required
          - `units` integer, required
          - `gmv_low` number, nullable, required
          - `gmv_high` number, nullable, required
          - `days_covered` integer, required
          - `lifetime_units` integer, required
      - `as_of` string, date-time, required
    - object
      - `status` 'not_collected', required
      - `brand_id` string, uuid, required
      - `reason` 'no_linked_shop' | 'no_daily_rows', 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)