---
title: "Shop GMV by channel with TikTok's comparison period"
method: POST
path: "/seller-center/shop-overview"
tags: ["Seller Center"]
---

# Shop GMV by channel with TikTok's comparison period

`POST /seller-center/shop-overview`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/seller-center/shop-overview`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

Window totals for the whole shop from the Seller Center overview, split by the channel the sale came through: video (creator vs seller), live (creator vs seller), and product card (shop tab vs search), plus product impressions / clicks and the derived click-through rate.

`comparison` carries the comparison-period totals TikTok attaches to each day, summed across the window, and `gmv_change_pct` derives the swing. TikTok chooses those periods (typically the immediately preceding equal-length window), so treat it as a directional benchmark rather than a window you control.

Related: **POST /shop-gmv/timeseries** gives the same channel hierarchy day by day, and **POST /shop-gmv/summary** gives the window totals without the comparison, product-card counts or listing impressions added here. `aov` is window GMV / window orders; `customers` is the sum of daily unique-buyer counts, so a buyer who purchased on two days is counted twice. Max range 90 days. Single-shop only — set `x-shop-id` to a specific shop ID. An empty result is a normal 200 response: Seller Center collection is per-shop and still rolling out.

## Request body

- SellerCenterWindowRequest: Date window shared by the windowed Seller Center surfaces.
  - `start_date` string, date, nullable: First day of the window (inclusive). Defaults to 30 days back.
  - `end_date` string, date, nullable: Last day of the window (inclusive). Defaults to yesterday.

## Response `200`

Successful Response

- SellerCenterShopOverviewResponse
  - `shop_id` integer, required
  - `currency_code` string, nullable
  - `start_date` string, required
  - `end_date` string, required
  - `day_count` integer, required
  - `gmv` number, required
  - `orders` integer, required
  - `items_sold` integer, required
  - `customers` integer, required
  - `aov` number, nullable
  - `channels` ShopOverviewChannels, required
    - `video` ChannelGmvSplit, required
      - `gmv` number, required
      - `affiliate` number, required
      - `seller` number, required
    - `live` ChannelGmvSplit, required
      - `gmv` number, required
      - `affiliate` number, required
      - `seller` number, required
    - `product_card` ProductCardGmvSplit, required
      - `gmv` number, required
      - `shop_tab` number, required
      - `search` number, required
      - `orders` integer, required
      - `customers` integer, required
  - `traffic` ShopOverviewTraffic, required
    - `product_impressions` integer, required
    - `product_clicks` integer, required
    - `product_ctr` number, nullable
    - `shop_tab_listing_impressions` integer, required
  - `comparison` ShopOverviewComparison, required: TikTok's own comparison-period totals, summed across the window.
    - `gmv` number, required
    - `orders` integer, required
    - `items_sold` integer, required
    - `customers` integer, required
    - `gmv_change_pct` number, nullable: (gmv - comparison.gmv) / comparison.gmv, as a percentage.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)