REreacherapp
Finance

Marketing and other fees by day or statement

Changed on

What TikTok charged the shop, from the settled statement lines, in six buckets: gmv_max, affiliate, referral, smart_promotion, campaign (campaign-period, flash-sale, co-funded and promotion-programme fees) and other (every remaining fee, including any TikTok adds later). The buckets always sum to fee_total; marketing_total is the first five; referral is TikTok's per-sale commission, listed because Seller Center's marketing cost view lists it. Amounts keep TikTok's sign, so a cost is negative. One row per day or per statement and currency, newest first; totals cover the whole window. Only settled lines count: check data_status.covered_until before reading a recent day as complete.

get/finance/marketing-costs

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/finance/marketing-costs
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Query parameters

start_datestring date nullable

Inclusive statement-date window start (UTC). Defaults to 29 days before end_date.

end_datestring date nullable

Inclusive statement-date window end (UTC). Defaults to yesterday.

group_by'day' | 'statement'

One row per statement date, or per statement.

limitinteger

Page size.

offsetinteger

Page offset.

Response

Successful Response

shop_idinteger required
tts_shop_idstring required
start_datestring required
end_datestring required
group_by'day' | 'statement' required
lines_scannedinteger required

Statement lines in the whole window, before paging; 0 means nothing has landed.

unparsed_fee_valuesinteger required

Fee values TikTok sent without a column that could not be read as amounts; non-zero means other is understated.

bucket_columnsobject required

The statement-line fee columns each bucket sums, so any amount can be traced.

Changes