AgentRouter
Sign in
KalodataKalodata

Rank TikTok Shop products

/product_rank

Search and rank TikTok Shop products by sales, revenue and other numeric metrics. Each page returns at most 100 records.

Finished calls, last 7 days
3
Success rate
100.0%
Median execution time
946ms

Cancellations excluded. Execution times cover successful calls.

Use it with your agent

Set up https://www.agentrouter.to/SKILL.md, then use Kalodata’s /product_rank endpoint through AgentRouter.

Inputs

regionOptional
TikTok Shop market.
languageOptional
Language for text fields.
currencyOptional
Currency for revenue and price fields.
date_rangeOptional
Named range lastDay/last7Day/last30Day/last60Day/last90Day/last180Day/last365Day, YYYY-MM-DD~YYYY-MM-DD, or YYYY-MM.
sort_fieldOptional
Sort by a numeric field returned by this endpoint.
page_numberOptional
Page number, starting at 1.
page_sizeOptional
Records per query, at most 100.
category_idsOptional
Restrict to these categories.
shop_idOptional
Shop ID, kept as a string to preserve all digits.
creator_idOptional
Creator ID, kept as a string to preserve all digits.
video_idOptional
Video ID, kept as a string to preserve all digits.
livestream_idOptional
Livestream ID, kept as a string to preserve all digits.
revenue_rangeOptional
Revenue filter in the requested currency, e.g. 100-1000, <100 or >1000.
is_affiliateOptional
1 selects affiliate products; 0 selects non-affiliate products.
commission_rateOptional
Commission rate filter, e.g. 15-35 or >=30.
is_tts_productOptional
1 selects fully managed products; 0 selects self-fulfilled products.
unit_price_rangeOptional
Unit price range filter in the requested currency.
need_allOptional
Include products without sales in the selected period.
delivery_typeOptional
Domestic or cross-border fulfillment.
launch_dateOptional
Days since product launch, e.g. <7 or >30.
need_imageOptional
0 omits the main image; 1 returns its official URL. The separate paid hosted-image service is excluded.
keywordOptional
Search by keyword.
need_extraOptional
Include additional fields such as seller name or SKU count.

Example input

{
  "region": "US",
  "page_size": 3
}

Output

Native Kalodata data, with IDs preserved as strings, sales and revenue metrics, and requested optional fields.