Seller Center

Shop GMV by channel with TikTok's comparison period

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.

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

Request body

start_datestring date nullable

First day of the window (inclusive). Defaults to 30 days back.

end_datestring date nullable

Last day of the window (inclusive). Defaults to yesterday.

Response

Successful Response

shop_idinteger required
currency_codestring nullable
start_datestring required
end_datestring required
day_countinteger required
gmvnumber required
ordersinteger required
items_soldinteger required
customersinteger required
aovnumber nullable

Changes

No operation changes recorded.