Per-SKU gross / contribution P&L
Changed onOne row per SKU: units sold and the fee lines from the order-level export summed over the window, joined to your cost of goods, with a gross profit and margin.
This is a GROSS / CONTRIBUTION view, not a net bottom line. The fees here are the ones TikTok books against the order itself — referral, affiliate commission, refunds, discounts and the like — and ad spend is NOT among them: TikTok does not attribute ad spend to a single SKU, so gross_profit is revenue less those per-SKU fees less COGS, and stops one step short of net earnings. For the true shop-level bottom line that includes ad spend, use POST /pnl/summary and POST /pnl/profit. If you request the net_earnings or total_expense columns they are the order-line totals and likewise exclude ad spend.
gross_profit is an upper bound while units_uncosted is non-zero — uncosted units are counted, never assumed free. Windowed by order PAID date; single shop only.
Request
- Base URLhttps://api.reacherapp.com/public/v1
- URLhttps://api.reacherapp.com/public/v1/pnl/skus
- AuthAPI key in header x-api-key and API key in header x-shop-id
Request body
Response
Successful Response
Changes
- breaking
the
/response's property type changed fromstringto no type for status - info
added
subschema #1subschema #2to the/response propertyanyOflist for the response status
- breaking
- info
endpoint added
- info