REreacherapp
Shop GMV

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

Changed on

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

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/shop-gmv/summary
  • Auth
    API key in header x-api-key and API key in header x-shop-id

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
currencystring nullable

ISO currency code; null when window has no data.

currency_codestring nullable

Deprecated alias of currency; use currency.

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 unique checkout orders (one per transaction, regardless of SKU count). This matches the Seller Center 'Orders' metric, not the per-product line count.

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

  • 291230805105Revision changes
    • info

      api operation id shop_gmv_summary_shop_gmv_summary_post removed and replaced with shop_gmv_summary

    • info

      added the optional property to the response with the status

    • info

      response property currency_code deprecated