Rank TikTok Shop videos
/video_rankSearch and rank TikTok Shop videos by sales, revenue and other numeric metrics. Each page returns at most 100 records.
- Finished calls, last 7 days
- 1
- Success rate
- 100.0%
- Median execution time
- 702ms
Cancellations excluded. Execution times cover successful calls.
Use it with your agent
Set up https://www.agentrouter.to/SKILL.md, then use Kalodata’s /video_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.
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.
followers_rangeOptional- Creator follower count filter, e.g. 1000-10000 or >1000.
ads_roasOptional- Estimated ad ROAS filter, e.g. 1-2.5, <1 or >5.
keywordOptional- Search by keyword.
is_ai_videoOptional- 1 selects AI videos; 0 selects non-AI videos; omit for both.
views_rangeOptional- View count filter, e.g. <10000, 10000-100000 or >1000000.
publish_date_rangeOptional- Days since publication, e.g. <7 for the past week.
Example input
{
"region": "US",
"page_size": 3
}Output
Native Kalodata data, with IDs preserved as strings, sales and revenue metrics, and requested optional fields.