Top-selling TikTok Shop creators
creator_top_selling[Shop Analytics] Creators (affiliates) ranked by the sales they drove over a date range: revenue, units, followers, engagement, views, trend. keyword = words in creator names, handles and bios (not the products they sell); category = a category name or id (levels 1-3: the creators selling in it, no keyword needed); both together narrow further. With neither, the result is the top 10 creators for the most recent days (about 6). Up to 100 rows per page with cursor paging, about 700 rows per keyword. sort: revenue, units, followers or growth; order=asc lists lowest first. Filters: revenue, followers, engagement, average views, price, growth, video or LIVE, gender, language, contact channel, MCN, audience age/language. region picks the market (default US). Examples: {"category":"Pet Supplies","followers":"10000-500000","contact":"EMAIL"}, {"keyword":"beauty","window":"7d","sort":"units"}.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "creator_top_selling"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day). | |
| mcn | No | Filter. Signed to an MCN (agency) or not. | |
| sort | No | Ranking metric: followers, growth, revenue, units. Default revenue. growth favours brand-new items (shown as >999.9%); pair it with a revenue or units filter. Applies with a keyword or category. | |
| debut | No | Filter. Days since the creator started selling: <4, <8, <31, or >30. | |
| limit | No | Results per page. Max 100 per page; pass next as cursor for the following page. Up to about 700 rows per keyword. Without a keyword or category: 10 rows. Values above a method's maximum are lowered and reported in notes. | |
| order | No | desc (default, highest first) or asc (lowest first among the matching rows; pair it with a revenue or units filter to skip dead listings). Applies with a keyword or category. | |
| price | No | Filter. Average price of what they sell, in the market's currency, e.g. <20. | |
| start | No | Shop Analytics methods: custom range start, YYYY-MM-DD. | |
| cursor | No | Paging: pass the next value from the previous response unchanged. Omit on the first page. | |
| detail | No | compact (default) returns the useful fields; full adds the full raw record (large). | compact |
| gender | No | Filter. Creator gender as the feed classifies it. | |
| region | No | Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions. | |
| window | No | Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range. | |
| contact | No | Filter. Only creators who list this contact channel. Several: comma separated, e.g. EMAIL,INSTAGRAM. Values: EMAIL, WHATSAPP, INSTAGRAM, YOUTUBE, FACEBOOK, TWITTER. | |
| growing | No | Filter. true = only creators whose revenue is growing. | |
| keyword | No | Matched against creator names, handles and bios (not the products they sell): 'pet' finds accounts like 'Pet Finds'. For the affiliates of a product type, pass category, or rank products with product_top_selling and call product method=creators on the top items. If keyword and category are both omitted, the result is the top 10 creators for the most recent days (about 6), whatever window is set: pass a keyword or category when the user wants more than 10 rows or a specific window. | |
| revenue | No | Filter. Revenue the creator drove in the market's currency over the window, e.g. >10000. | |
| category | No | Narrow to one or more Shop categories (up to 5), by name or numeric id, levels 1 to 3: ["Skincare"], ["Pet Supplies"], ["Beauty & Personal Care","Health"] or ["601450"]. Without a keyword the creators of the category are found by merging several generic keyword searches (a keyword is needed), and the result says how many keyword sweeps and distinct rows that gave. Find names and ids with category_trends method=tree. | |
| language | No | Filter. Creator language. | |
| avg_views | No | Filter. Average video views, e.g. >10000. | |
| followers | No | Filter. Followers, e.g. 50000-500000. | |
| engagement | No | Filter. Video engagement rate percent, e.g. >8. | |
| account_type | No | Filter. BELONGED_TO_SELLER = a brand's own account; INDEPENDENT = affiliate creator. | |
| audience_age | No | Filter. Main follower age band. | |
| revenue_source | No | Filter. Main revenue source: VIDEO or LIVE. | |
| audience_language | No | Filter. Main follower language. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||