Rank TikTok Shop products
/product_rankSearch 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.