Seller Center

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.

get/seller-center/buyers-ranking

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/seller-center/buyers-ranking
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Query parameters

ranking_type'product' | 'video'

Rank products or videos.

limitinteger

Max entries (max 200).

Response

Successful Response

shop_idinteger required

Changes

No operation changes recorded.