TikTok Intelligence KD
TikTok Creator Rankings MCP
Query TikTok creator rankings by region and date range. Call the TikTok Creator Rankings API via REST or MCP with your Nexscope API key.
TikTok Creator Rankings AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Query TikTok Creator Rankings By Region And Date Range
Prompt: Query TikTok creator rankings by region and date range in [target marketplace]. Show the available results and clearly identify missing information.
2. Research In A Selected Currency
Prompt: Query TikTok creator rankings by region and date range in [target marketplace]. Present the available monetary values in [my selected currency], using [my supplied conversion rate] only if the tool requires one. Do not compare amounts in different currencies.
3. Research In A Selected Language
Prompt: Query TikTok creator rankings by region and date range in [target marketplace]. Return the available descriptions in [my preferred supported language], while keeping identifiers unchanged.
4. Review A Specific Reporting Period
Prompt: Query TikTok creator rankings by region and date range in [target marketplace]. Use [my chosen reporting period] and show the period with the returned figures. Keep dated snapshots distinct from current data.
5. Continue The Results Within A Page Limit
Prompt: Query TikTok creator rankings by region and date range in [target marketplace]. Start at [my selected page] and return [my requested page size] within the documented limits. Ask before requesting another page and do not describe one page as the complete dataset.
6. Prioritize The Results For Review
Prompt: Query TikTok creator rankings by region and date range in [target marketplace]. Prioritize [my chosen ranking metric] in [my chosen order]. Keep the ranking limited to the selected filters and reporting period.
What You Need to Provide
Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.
Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_tiktok_creator_searchhttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "tiktok-creator-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_creator_search",
"arguments": {
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 10,
"region": "US"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
region | string | optional | Optional TikTok Shop market region. Example: US |
dateRange | string | optional | Relative date range. Example: last30Day |
pageNumber | integer | optional | Page number, 1-5. Finite numeric strings and optional null remain accepted by the backend for compatibility. Example: 1 |
pageSize | integer | optional | Rows per page, 5-100. Finite numeric strings and optional null remain accepted by the backend for compatibility. Example: 10 |
currency | string | optional | Currency code. Example: USD |
language | string | optional | Response language. Example: en-US |
sortField | object | optional | Optional provider sort object. Example: {} |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
errcode | integer | optional | Business status code, `200` indicates success |
data | array | optional | List or detailed data; real responses do not contain `total` |
costToken | integer | optional | The deduction token for this call is usually `14000` |
errmsg | string | optional | Status message, `ok` on success |
creator_nickname | string | optional | Expert nickname |
creator_handle | string | optional | TikTok page name, such as `@based` |
creator_id | string | optional | Expert’s unique ID, string format to avoid loss of precision for large integers |
creator_followers | string | optional | Number of fans, returned as a string |
content_views | string | optional | The total number of views of the content, returned as a string |
sales_volumn | integer | optional | Sales volume, field spelled `volumn` |
revenue | number | optional | Total sales/GMV, returned by requested `currency` |
video_revenue | number | optional | Short video sales |
live_revenue | number | optional | Live streaming sales |
revenue_growth_rate | number | optional | Sales growth rate (%), can be positive or negative |
creator_id | string | optional | Master's unique ID |
creator_nickname | string | optional | Expert nickname |
creator_handle | string | optional | Expert handle |
creator_region | string | optional | Expert area |
creator_status | string | optional | Master status |
creator_bio | string | optional | Profile of the expert |
creator_belonged_shop_id | string | optional | Store ID |
creator_followers | string | optional | Total number of fans, returned as a string |
new_followers | integer | optional | Add new fans in `dateRange` window |
revenue | number | optional | Total Sales/GMV |
video_revenue | number | optional | video sales |
live_revenue | number | optional | Live sales |
sales_volumn | integer | optional | Sales volume, field spelled `volumn` |
unit_price | number | optional | unit price |
video_number | integer | optional | Number of videos in the window |
video_views | integer | optional | Total video views |
video_gpm | number | optional | Video GPM |
live_number | integer | optional | Number of live broadcasts within the window |
live_views | integer | optional | Total live views |
live_gpm | number | optional | Live GPM |
product_number | integer | optional | Number of related products |
shop_number | integer | optional | Number of associated stores |
creator_contact_email | string | optional | Contact email |
creator_contact_ins | string | optional | Instagram Contact |
creator_contact_whatsapp | string | optional | WhatsApp Contact |
creator_contact_facebook | string | optional | Facebook Contact |
creator_contact_tiktok | string | optional | TikTok contact information |
creator_contact_zalo | string | optional | Contact Us |
creator_contact_line | string | optional | Line contact information |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Query TikTok creator rankings by region and date range. Focus on the US.
Illustrative Response Explanation
The illustrative result shows revenue: 19.99; sales volumn: 10. These figures describe only the shown record. Missing measures cannot be calculated from this example.
About this sample: Illustrative example with fictional records, not a live tool call. Identifiers, prices and counts are demonstration values.
View the Published Sample Data (JSON)
Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.
Data Example
Sample request and response
Request parameters
{
"region": "VN",
"keyword": "tai nghe"
}Response
{
"code": 0,
"msg": null,
"data": {
"data": [
{
"revenue_growth_rate": -16.21,
"revenue": 414508.08,
"video_revenue": 234.83,
"sales_volumn": 33181,
"content_views": "14386759",
"creator_followers": "4700000",
"creator_id": "6915637132371657729",
"creator_handle": "@quyenleo",
"creator_nickname": "Quyền Leo",
"live_revenue": 387398.84
},
{
"revenue_growth_rate": -17.98,
"revenue": 385569.34,
"video_revenue": 350.3,
"sales_volumn": 16958,
"content_views": "18730392",
"creator_followers": "2100000",
"creator_id": "7286334200113382408",
"creator_handle": "@ungthaimenuochoa",
"creator_nickname": "Ưng Thái",
"live_revenue": 384567.72
},
{
"revenue_growth_rate": 3.34,
"revenue": 352807.2,
"video_revenue": 109319.75,
"sales_volumn": 39490,
"content_views": "20941280",
"creator_followers": "740500",
"creator_id": "6978523869728965633",
"creator_handle": "@thanhdongian.dtt",
"creator_nickname": "Thành Đơn Giản",
"live_revenue": 241913.73
},
{
"revenue_growth_rate": -75.54,
"revenue": 326777.6,
"video_revenue": 164256.46,
"sales_volumn": 29982,
"content_views": "18249528",
"creator_followers": "2400000",
"creator_id": "6798739018520839169",
"creator_handle": "@chanhbeauty93",
"creator_nickname": "Nguyễn Thị Kim Xuyến's",
"live_revenue": 151371.99
},
{
"revenue_growth_rate": -40.09,
"revenue": 268523.01,
"video_revenue": 9719.18,
"sales_volumn": 24242,
"content_views": "4740083",
"creator_followers": "819800",
"creator_id": "154547111739473920",
"creator_handle": "@ngockhanhday",
"creator_nickname": "Ngọc Khánh đây",
"live_revenue": 251226.56
},
{
"revenue_growth_rate": -57.88,
"revenue": 268191.37,
"video_revenue": 1713.2,
"sales_volumn": 14841,
"content_views": "3022436",
"creator_followers": "466000",
"creator_id": "6882276426629252097",
"creator_handle": "@thegioimebimsua",
"creator_nickname": "Thế Giới Mẹ Bỉm Sữa",
"live_revenue": 261106.6
},
{
"revenue_growth_rate": 3.81,
"revenue": 262168.73,
"video_revenue": 447.24,
"sales_volumn": 9367,
"content_views": "4364385",
"creator_followers": "1700000",
"creator_id": "7047795841113015298",
"creator_handle": "@kimtronsalan1994",
"creator_nickname": "Kim Tròn Sà Lan",
"live_revenue": 256175.93
},
{
"revenue_growth_rate": -3.28,
"revenue": 258061.83,
"video_revenue": 104892.33,
"sales_volumn": 13215,
"content_views": "7753245",
"creator_followers": "1300000",
"creator_id": "7185560290230420482",
"creator_handle": "@realpewpew",
"creator_nickname": "Tạp Hóa PewPew",
"live_revenue": 146988.84
},
{
"revenue_growth_rate": -62.46,
"revenue": 244176.67,
"video_revenue": 17446.64,
"sales_volumn": 6765,
"content_views": "5183892",
"creator_followers": "2100000",
"creator_id": "7072683155098272773",
"creator_handle": "@hannaholala",
"creator_nickname": "HannahOlala",
"live_revenue": 185305.97
},
{
"revenue_growth_rate": 63.51,
"revenue": 232200.27,
"video_revenue": 122285.39,
"sales_volumn": 13948,
"content_views": "100976643",
"creator_followers": "522000",
"creator_id": "7132359344935715866",
"creator_handle": "@cerave.vietnam_official",
"creator_nickname": "CeraVe Việt Nam",
"live_revenue": 107976.67
},
{
"revenue_growth_rate": -15.71,
"revenue": 223957.62,
"video_revenue": 2711.05,
"sales_volumn": 55372,
"content_views": "14639568",
"creator_followers": "578200",
"creator_id": "7095071270736364546",
"creator_handle": "@hieubanhlamthuy",
"creator_nickname": "Tiệm Bánh Lâm Thủy Cổ Truyền",
"live_revenue": 221164.89
},
{
"revenue_growth_rate": -22.61,
"revenue": 223119.65,
"video_revenue": 0,
"sales_volumn": 14903,
"content_views": "549659",
"creator_followers": "208600",
"creator_id": "6705337685530117121",
"creator_handle": "@hinhy_review",
"creator_nickname": "Hiền Hinhy",
"live_revenue": 218528.18
},
{
"revenue_growth_rate": -28.62,
"revenue": 217684.72,
"video_revenue": 72.48,
"sales_volumn": 4513,
"content_views": "503950",
"creator_followers": "247300",
"creator_id": "7088240910156923905",
"creator_handle": "@phuongsena",
"creator_nickname": "Phương Sena",
"live_revenue": 212526.53
},
{
"revenue_growth_rate": -56.4,
"revenue": 212316.94,
"video_revenue": 1317.18,
"sales_volumn": 17086,
"content_views": "1324711",
"creator_followers": "253900",
"creator_id": "6628200945636753409",
"creator_handle": "@hungeverything",
"creator_nickname": "Hưng Everything ☻",
"live_revenue": 207628.75
},
{
"revenue_growth_rate": 6.51,
"revenue": 201761.75,
"video_revenue": 40154.35,
"sales_volumn": 15394,
"content_views": "5309890",
"creator_followers": "1600000",
"creator_id": "7092274959032992770",
"creator_handle": "@laquocquyen",
"creator_nickname": "Lã Quốc Quyền",
"live_revenue": 158247.25
},
{
"revenue_growth_rate": -15.94,
"revenue": 177135.27,
"video_revenue": 0,
"sales_volumn": 3636,
"content_views": "885495",
"creator_followers": "48100",
"creator_id": "7628809448744961040",
"creator_handle": "@trangsuckimbao999",
"creator_nickname": "Trang Sức Kim Bảo",
"live_revenue": 168171.01
},
{
"revenue_growth_rate": -26.6,
"revenue": 172962.58,
"video_revenue": 120366.37,
"sales_volumn": 29090,
"content_views": "13510150",
"creator_followers": "737500",
"creator_id": "6875773744855204865",
"creator_handle": "@totuyettram",
"creator_nickname": "Tô Tuyết Trâm",
"live_revenue": 51808.49
},
{
"revenue_growth_rate": -91.21,
"revenue": 164161.86,
"video_revenue": 0,
"sales_volumn": 3194,
"content_views": "392369",
"creator_followers": "5700",
"creator_id": "6749811226706838529",
"creator_handle": "@hunghanhtools",
"creator_nickname": "Hằng Review Đồ Nghề",
"live_revenue": 164161.86
},
{
"revenue_growth_rate": -10.55,
"revenue": 162454.54,
"video_revenue": 21451.29,
"sales_volumn": 10096,
"content_views": "899941",
"creator_followers": "99800",
"creator_id": "6905265191504954370",
"creator_handle": "@thegioibimsua0",
"creator_nickname": "Thế Giới Bỉm Sữa ✅",
"live_revenue": 139592.21
},
{
"revenue_growth_rate": -31.01,
"revenue": 161997,
"video_revenue": 25556.89,
"sales_volumn": 14896,
"content_views": "3279426",
"creator_followers": "742300",
"creator_id": "7068480615218070529",
"creator_handle": "@cocoon.vietnam",
"creator_nickname": "Cocoon Vietnam",
"live_revenue": 135071.68
}
]
}
}View the MCP Request & Response Format
Examples
Illustrative example with fictional data, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "tiktok-creator-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_creator_search",
"arguments": {
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 10,
"region": "US"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "tiktok-creator-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"revenue\":19.99,\"sales_volumn\":10}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"revenue": 19.99,
"sales_volumn": 10
}
]
}
},
"isError": false
}
}