REreacherapp
Shop Health

Daily Shop Performance Score (SPS) trend

Changed on

Daily Shop Performance Score for one shop — the same SPS shown in Seller Center (US shops via TikTok's official shop_performances/overview API, other markets via Seller Center). Each point carries sps_score (0-5), sps_tier, peer_percentile, and a dimensions breakdown of the sub-metrics (on-time dispatch, negative-review rate, etc.).

Single-shop only — set x-shop-id to a specific shop ID. Defaults to the last 30 days ending yesterday. Max range 90 days. Only shops on the shop-health sync are covered; an empty series is a normal 200 response (history builds from the first daily pull).

post/shop-health/timeseries

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/shop-health/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 (30-day window). Max window 90 days.

end_datestring date nullable

Inclusive window end (YYYY-MM-DD). Defaults to yesterday (today's snapshot is not recorded until the daily pull runs).

Response

Successful Response

shop_idinteger required
start_datestring required
end_datestring required

Changes

  • 291230805105Revision changes
    • info

      api operation id shop_health_timeseries_shop_health_timeseries_post removed and replaced with shop_health_timeseries