Skip to main content
GET
Shop Bestsellers
Ranked by each product’s real sold_count (source: "sales_ranked"). Omit category_id for a market-wide list, or pass one to rank within a category. pages (1-4) controls how many category pages are aggregated before ranking; limit (1-100) caps the returned list.
Markets — available for every operating market: US, GB, ID (Tokopedia), and the Southeast Asian markets SG, MY, PH, TH, VN plus JP, each in its local currency. This is the recommended trending/best-seller endpoint for markets where TikTok exposes no curated ranking page. region=TW returns HTTP 200 with availability: "not_operated" and an empty list — TikTok operates no Shop marketplace in Taiwan.
Each request costs 5 credits. Failed requests are not charged.

Authorizations

x-api-key
string
header
required

Query Parameters

region
string
default:US

Market: US, GB, ID, SG, MY, PH, TH, VN, JP.

category_id
string | null

Optional category to rank within; omit for a market-wide list.

Pattern: ^[1-9][0-9]{0,18}$
pages
integer
default:2

Category pages to aggregate (1-4).

Required range: 1 <= x <= 4
limit
integer
default:20

Max products to return (1-100).

Required range: 1 <= x <= 100

Response

200 - application/json

Successful Response

region
string
required
products
ShopProduct · object[]
source
string
default:sales_ranked

Ranking source; 'sales_ranked' = ordered by real sold_count.

category_ids
string[]

Categories aggregated to build the ranking.