AgentRouter
Sign in
KalodataKalodata

Rank TikTok Shop creators

/creator_rank

Search 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.