---
title: "Shop-tab / search channel stats with industry benchmarks"
method: POST
path: "/seller-center/channels"
tags: ["Seller Center"]
---

# Shop-tab / search channel stats with industry benchmarks

`POST /seller-center/channels`

## Request

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

Per-channel performance for the window from the Seller Center shop-tab stats — one entry per channel (`shop_tab`, `search`, `other`) with GMV, impressions, units sold and customers.

`baseline` is TikTok's previous-period value for the same metrics, summed across the window. `industry_median` is the typical seller in this shop's industry — a benchmark, not an additive quantity, so it is reported as the most recent day in the window that carried one (`as_of`) rather than summed or averaged. It is `null` when TikTok returned no benchmark for the window; the daily collection path does not always include one.

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

- SellerCenterChannelsResponse
  - `shop_id` integer, required
  - `currency_code` string, nullable
  - `start_date` string, required
  - `end_date` string, required
  - `data` SellerCenterChannel[], required
    - `channel` string, required: `shop_tab`, `search` or `other`.
    - `day_count` integer, required
    - `gmv` number, required
    - `impressions` integer, required
    - `units_sold` integer, required
    - `customers` integer, required
    - `units_per_impression` number, nullable
    - `baseline` ChannelBaseline, required: TikTok's previous-period values, summed across the window.
      - `gmv` number, nullable
      - `impressions` integer, nullable
      - `units_sold` integer, nullable
      - `customers` integer, nullable
    - `industry_median` ChannelIndustryMedian: The typical seller in this shop's industry, as of one day.
      - `as_of` string, required: The day this benchmark was collected.
      - `gmv` number, nullable
      - `impressions` integer, nullable
      - `units_sold` integer, nullable
      - `customers` integer, nullable

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