Products or videos ranked by new-customer acquisition
The shop's products (ranking_type=product) or videos (ranking_type=video) ranked by how many new customers they brought in, from customers.sc_buyers_ranking. Use it to find the product or piece of content that actually acquires buyers, as opposed to the one that generates the most GMV from buyers you already had.
customer_contribution is the entity's share (0-1) of the shop's new customers over TikTok's trailing period_months window (12 by default).
No date window: this is a snapshot ranking that TikTok recomputes and the collector overwrites wholesale. Collection of this ranking is currently paused upstream, so the response reflects the last snapshot collected for the shop. Single-shop only — set x-shop-id to a specific shop ID. An empty result is a normal 200 response: Seller Center collection is per-shop and still rolling out.
Request
- Base URLhttps://api.reacherapp.com/public/v1
- URLhttps://api.reacherapp.com/public/v1/seller-center/buyers-ranking
- AuthAPI key in header x-api-key and API key in header x-shop-id
Query parameters
Rank products or videos.
Max entries (max 200).
Response
Successful Response
Changes
No operation changes recorded.