REreacherapp
Shop Performance

Shop sales series (GMV, orders, units, visitors, conversion rate)

Changed on

Daily or weekly (Sunday-start) sales for one shop from TikTok's official Seller Center analytics. Each bucket says how many days it covers and whether it is complete, so a partial current week is never mistaken for a decline. Window: a preset (7d, 30d, 90d, 12m, all) ending at the shop's newest stored day, or explicit start_date/end_date; max 365 days. Single-shop only. An empty points list is a normal 200 for shops the collector does not cover yet.

post/shop-performance/timeseries

Request

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

Request body

presetstring nullable

Relative window ending at the shop's newest settled day: <n>d (1-999), <n>m (1-99) or all, always capped at 365 days. Mutually exclusive with explicit dates; defaults to 30d when neither is given.

start_datestring date nullable

Inclusive window start (YYYY-MM-DD).

end_datestring date nullable

Inclusive window end (YYYY-MM-DD).

granularity'day' | 'week'

day returns one point per day; week sums Sunday-start weeks.

Response

Successful Response

shop_idinteger required
currency_codestring nullable

Null when the window mixes currencies; points carry their own.

start_datestring required
end_datestring required
granularity'day' | 'week' required
week_start'sunday'
latest_available_datestring nullable

Newest stored day for this shop, or null when nothing is stored.

earliest_available_datestring nullable

Oldest stored day for this shop, or null when nothing is stored. A prior-period comparison is only meaningful when the prior window starts on or after this day.

is_completeboolean required

Changes