REreacherapp
Products

List products

Changed on

Product performance metrics aggregated over a date range. Defaults to the last 7 days if no dates are specified. Data is typically 2-3 days behind the current date. Each product also carries its TikTok Seller Center per-product metrics as sc_* fields: all-channel GMV with its per-channel breakdown (affiliate, seller video, seller live, product card, shop tab), plus orders, units sold, customers, impressions, clicks, CTR, conversion, AOV, GMV per 1,000 impressions, add-to-cart, and refunds. The sc_* fields are null for products not yet on the Seller Center sync.

post/products/list

Request

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

Request body

pageinteger
page_sizeinteger
sort_by'gmv' | 'units_sold' | 'video_count' | 'sample_count' | 'est_commission' nullable
sort_dir'asc' | 'desc'
start_datestring date nullable
end_datestring date nullable
product_namestring nullable

Response

Successful Response

currencystring required
paginationunknown required
shops_queriedstring[] nullable

Shop names included when querying multiple shops (x-shop-id: all or comma-separated).

Changes