Campaign prep: price, stock, COGS, fees and break-even ROAS per SKU
Changed onPrepares one shop's products for a TikTok platform campaign or flash sale. Per SKU: current price, warehouse stock, cost of goods, TikTok fees, the margin left for ad spend and the break-even ROAS = selling price / (selling price - COGS - fees), where the selling price is the price less discount_pct (rounded to the cent) and fees are fee_rate of it. Read-only: it registers nothing with TikTok.
COGS comes from the shop's stored costs; SKUs without one fall back to this request's cogs rows, then to margin_pct (cogs_source); cogs rows not applied to any SKU are listed in caller_cogs_unused. Fees are measured from the shop's P&L order lines over fee_window_days (TikTok's own total expense per line — referral, affiliate commission, shipping — as a share of net sales, on the SKU or else across its product; ad spend is not included), or taken from fee_rate when given (fees_source). Nothing missing is assumed: break_even_roas is null and status says why — no_price (a multi-variant product whose only current price is its range), no_cogs (no stored, caller or margin COGS), no_fee_data (no usable P&L fee data and no fee_rate) or no_break_even (costs meet or exceed the selling price). missing_inputs lists every missing input, and the skus_with_* counts say how much of skus_scanned each input covers. Single-shop only.
Request
- Base URLhttps://api.reacherapp.com/public/v1
- URLhttps://api.reacherapp.com/public/v1/product-insights/campaign-prep
- AuthAPI key in header x-api-key and API key in header x-shop-id
Request body
Response
Successful Response
Changes
- info
endpoint added
- info