REreacherapp
Halo Effect Tracker

Aligned daily series across all four channels

Changed on

Every halo channel on one contiguous date axis: TikTok views and GMV, Amazon revenue, Shopify revenue, branded-search volume and click share. dates[i] indexes every other array, so the arrays can be plotted or diffed element-wise without re-joining on date.

A null means no data for that day; a 0 means a real zero — the distinction is preserved deliberately, and channels the shop hasn't connected are null throughout. Pass amazon_asins / shopify_product_ids to scope revenue (and branded search) to specific products; omit them for shop totals.

TikTok points are only daily-resolved for the most recent ~30 days — beyond that TikTok's stored series is monthly-bucketed and cannot be aligned to days, so tiktok_views / tiktok_gmv come back null for the out-of-coverage tail while the revenue series stay complete. Defaults to the last 30 days ending yesterday; max 366. Single-shop only.

post/halo/timeseries

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/halo/timeseries
  • 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 (a 30-day window). Max window 366 days.

end_datestring date nullable

Inclusive window end (YYYY-MM-DD). Defaults to yesterday — today's revenue rows have not been pulled yet.

amazon_asinsstring[] nullable

Restrict Amazon revenue and branded search to these ASINs. Omit for the shop total. Values come from GET /halo/products.

shopify_product_idsstring[] nullable

Restrict Shopify revenue to these product IDs. Omit for the shop total. Values come from GET /halo/products.

Response

Successful Response

shop_idinteger required
start_datestring required
end_datestring required
datesstring[] required

Contiguous date axis; every series aligns.

tiktok_viewsinteger[] required
tiktok_gmvnumber[] required
amazon_revenuenumber[] required
shopify_revenuenumber[] required
branded_search_termsinteger[] required
branded_search_click_sharenumber[] required

Changes