GMV Max

Exclude a video from GMV Max

Changed on

Exclude ONE video (creative) from this shop's GMV Max delivery, by TikTok video_id, without excluding its creator — use this to cut an unprofitable creative (e.g. zero orders at $10+ spend) while the creator's other videos keep delivering. The reconcile job removes the creative from every active campaign it is delivering in within ~4 hours and verifies it flipped to EXCLUDED. Idempotent on (shop, video_id): re-excluding an already excluded video keeps its current applied_status. Requires read_write scope and an Idempotency-Key. Single shop only. For many videos at once use POST /gmv-max/excluded-videos/bulk.

post/gmv-max/excluded-videos

Request

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

Headers

Idempotency-Keystring nullable

Request body

video_idstring required

The TikTok video id to exclude — the same video_id / material_id returned by the GMV Max video and creative-metrics tools (a pasted TikTok video URL is accepted and unwrapped). Only this creative comes off spend; the creator's other videos keep delivering.

reasonstring nullable

Optional free-text note (e.g. 'zero orders at $12 spend').

Response

Successful Response

Changes

    • breaking

      the // response's property format changed from date-time to no format for status

    • breaking

      the // response's property format changed from date-time to no format for status

    • info

      endpoint added