Sign in
Shop GMV

Shop GMV window totals (Seller Center, full shop view)

Window totals for one shop from the TikTok Seller Center daily rollup — SUMmed across the window with the same channel hierarchy as the timeseries response.

Same coverage caveats as the timeseries endpoint. aov is recomputed as total GMV / total orders over the window (a window-correct value, not the average of daily AOVs). customers is the SUM of daily unique-customer counts — buyers who purchased on multiple days are double-counted; a true window-distinct count is not derivable from this rollup.

post/shop-gmv/summary

Request body

start_datestring date nullable

Inclusive window start (YYYY-MM-DD). Defaults to 29 days before end_date.

end_datestring date nullable

Inclusive window end (YYYY-MM-DD). Defaults to yesterday.

Response

Successful Response

shop_idinteger required
currency_codestring nullable

ISO currency code; null when window has no data.

start_datestring required
end_datestring required
day_countinteger required

Number of daily rows that contributed to these totals.

gmvnumber required

SUM of daily GMV across the window.

ordersinteger required

SUM of daily orders.

items_soldinteger required

SUM of daily units sold.

customersinteger required

SUM of daily unique-customer counts. NOTE: this double-counts buyers who purchased on multiple days; the source rollup is unique-per-day. A true window-distinct count is not derivable from this table.

aovnumber nullable

Window-level AOV computed as total GMV / total orders over the window. null when there are no orders. Note: this is NOT the average of daily AOV values (which would be meaningless since daily AOVs have different denominators).

Changes

No recorded changes to this endpoint across all 5 revisions of this API.