GMV Max

Per-video GMV Max spend and performance (across campaigns)

Changed on

GMV Max ad spend and performance at the video (creative) grain for one shop — one row per TikTok video across every campaign it delivered in during the window: spend, orders, cost per order, ROI, revenue, impressions, clicks, CTR (ad click rate), video CTR (product click rate), latest delivery status, surface, the video's posted date and creator when it is an affiliate video, and whether it is already on the shop's exclusion list. This is the per-creative export a media buyer pulls from Ads Manager by hand.

Totals are SUMs over the window; cost_per_order and roi are recomputed from the summed bases; ctr / video_ctr are impressions-weighted. Filter with campaign_id and min_spend (e.g. min_spend: 10 with orders == 0 to find creatives to exclude), sort with sort_by / sort_dir, page with page / page_size (max 200). Exclude a video with POST /gmv-max/excluded-videos (or /bulk).

Single-shop only. Defaults to the last 30 days ending yesterday; max range 90 days. Empty data is a normal 200.

post/gmv-max/videos/summary

Request

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

campaign_idstring nullable

Restrict to a single GMV Max campaign.

min_spendnumber nullable

Only videos whose window spend is at least this amount.

sort_by'spend' | 'revenue' | 'orders' | 'roi' | 'cost_per_order' | 'ctr' | 'video_ctr' | 'last_active_date'

Column to sort by.

sort_dir'asc' | 'desc'
pageinteger
page_sizeinteger

Response

Successful Response

shop_idinteger required
currencystring required

ISO currency code for the shop's region.

start_datestring required
end_datestring required

Changes