REreacherapp
GMV Max

Daily product-level GMV Max metrics (per product, per campaign)

Changed on

Daily GMV Max metrics broken down to the product (SPU / item_group_id) level for one shop — cost, gross revenue (GMV), SKU orders, ROI, and cost-per-order per product per day. This is the grain behind TikTok Seller Center's per-campaign Product table.

Optionally filter to a single campaign_id and/or item_group_id. item_group_id (aliased as product_id) is the join key to the product / Seller Center product datasets.

Single-shop only — set x-shop-id to a specific shop ID. Defaults to the last 30 days ending yesterday; max range 90 days. Empty data is a normal 200 (a shop may have no GMV Max campaigns).

roi and cost_per_order are TikTok's stored daily values — for window totals use /gmv-max/products/summary, which recomputes them from the summed bases.

post/gmv-max/products/timeseries

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/gmv-max/products/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).

end_datestring date nullable

Inclusive window end (YYYY-MM-DD). Defaults to yesterday (today's row is still incomplete).

campaign_idstring nullable

Restrict to a single GMV Max campaign.

item_group_idstring nullable

Restrict to a single product (TikTok SPU / item_group_id).

Response

Successful Response

shop_idinteger required
currencystring required

ISO currency code for the shop's region.

start_datestring required
end_datestring required

Changes

  • 291230805105Revision changes
    • info

      api operation id gmv_max_products_timeseries_gmv_max_products_timeseries_post removed and replaced with gmv_max_products_timeseries

    • info

      added the optional property // to the response with the status

    • info

      response property data/items/cost deprecated