REreacherapp
Shop GMV

Daily shop GMV time series (Seller Center, full shop view)

Changed on

Daily GMV for one shop from the TikTok Seller Center daily rollup, including channel breakdown (video → affiliate/seller, live → affiliate/seller, product_card → shop_tab/search) and traffic (product impressions/clicks).

Differs from POST /metrics/timeseries metric=gmv — that endpoint reports affiliate-attributed GMV only (Reacher's view of creator-driven sales). This endpoint reports the total shop GMV including ads / Smart+ and organic. Use this when the customer wants numbers matching their TikTok Seller Center dashboard.

Single-shop only — set x-shop-id to a specific shop ID. Defaults to last 30 days ending yesterday. Max range 90 days (TikTok backfill depth). The newest available day is yesterday; today's row is not returned. Empty series is a normal 200 response — Seller Center coverage is still rolling out.

post/shop-gmv/timeseries

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/shop-gmv/timeseries
  • 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 (30-day window). The Seller Center data is back-filled ~90 days per shop, so older ranges will return an empty series.

end_datestring date nullable

Inclusive window end (YYYY-MM-DD). Defaults to yesterday (today is excluded because the daily row is still incomplete).

Response

Successful Response

shop_idinteger required
currencystring nullable

ISO currency code applying to every point in the series (e.g. 'GBP', 'USD'). null when the series is empty or (defensively) when the source rows somehow mix currencies for the same shop — in that case GMV values should not be summed in the client.

currency_codestring nullable

Deprecated alias of currency; use currency.

granularitystring

Always 'daily' in v1.

start_datestring required
end_datestring required

Changes

  • 291230805105Revision changes
    • info

      api operation id shop_gmv_timeseries_shop_gmv_timeseries_post removed and replaced with shop_gmv_timeseries

    • info

      added the optional property to the response with the status

    • info

      response property currency_code deprecated