Rank TikTok Shop creators
/creator_rankSearch and rank TikTok Shop creators by sales, revenue and other numeric metrics. Each page returns at most 100 records.
- Finished calls, last 7 days
- 0
Cancellations excluded. Execution times cover successful calls.
Use it with your agent
Set up https://www.agentrouter.to/SKILL.md, then use Kalodata’s /creator_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_id_listOptional- Comma-separated category IDs.
shop_idOptional- Shop ID, kept as a string to preserve all digits.
product_idOptional- Product ID, kept as a string to preserve all digits.
revenue_rangeOptional- Revenue filter in the requested currency, e.g. 100-1000, <100 or >1000.
creator_typeOptional- Seller-owned or independent affiliate creator.
followers_rangeOptional- Creator follower count filter, e.g. 1000-10000 or >1000.
engagement_rateOptional- Engagement bucket: below 8%, 8%-20%, or above 20%.
keywordOptional- Search by keyword.
need_imageOptional- 0 omits the main image; 1 returns its official URL. The separate paid hosted-image service is excluded.
need_categoryOptional- Include category information.
need_ter_categoryOptional- Include leaf category information.
Example input
{
"region": "US",
"page_size": 3
}Output
Native Kalodata data, with IDs preserved as strings, sales and revenue metrics, and requested optional fields.