TikTok Intelligence KD
TikTok Creator Analytics MCP
Compare TikTok creators by followers, sales revenue, and region. Call the TikTok Creator Analytics API via REST or MCP with your Nexscope API key.
TikTok Creator Analytics 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. Compare TikTok Creators By Followers, Sales Revenue, And Region
Prompt: Compare TikTok creators by followers, sales revenue, and region for [creator ID] in [target marketplace]. Show the available results and clearly identify missing information.
2. Research In A Selected Language
Prompt: Compare TikTok creators by followers, sales revenue, and region for [creator ID] in [target marketplace]. Return the available descriptions in [my preferred supported language], while keeping identifiers unchanged.
3. Research In A Selected Currency
Prompt: Compare TikTok creators by followers, sales revenue, and region for [creator ID] 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.
4. Review A Specific Reporting Period
Prompt: Compare TikTok creators by followers, sales revenue, and region for [creator ID] 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: Compare TikTok creators by followers, sales revenue, and region for [creator ID] 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: Compare TikTok creators by followers, sales revenue, and region for [creator ID] in [target marketplace]. Prioritize [my chosen ranking metric] in [my chosen order]. Keep the ranking limited to the selected filters and reporting period.
7. Find Matches By Revenue / GMV
Prompt: Compare TikTok creators by followers, sales revenue, and region for [creator ID] in [target marketplace]. Limit results to [my chosen revenue / gmv range]. Keep the lower and upper bounds consistent and show only the matching records.
8. Find Matches By Follower
Prompt: Compare TikTok creators by followers, sales revenue, and region for [creator ID] in [target marketplace]. Limit results to [my chosen follower range]. Keep the lower and upper bounds consistent and show only the matching records.
9. Narrow Results By Category ID List
Prompt: Compare TikTok creators by followers, sales revenue, and region for [creator ID] in [target marketplace]. Use [my selected category id list] to narrow the results. Report only what the selected records support.
10. Narrow Results By Shop ID
Prompt: Compare TikTok creators by followers, sales revenue, and region for [creator ID] in [target marketplace]. Use [my selected shop id] to narrow the results. Report only what the selected records support.
11. Narrow Results By Creator Type
Prompt: Compare TikTok creators by followers, sales revenue, and region for [creator ID] in [target marketplace]. Use [my selected creator type] to narrow the results. Report only what the selected records support.
12. Narrow Results By Engagement-Rate
Prompt: Compare TikTok creators by followers, sales revenue, and region for [creator ID] in [target marketplace]. Use [my selected engagement-rate] to narrow the results. Report only what the selected records support.
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_analyticshttps://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-analytics-1",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_creator_analytics",
"arguments": {
"creatorId": "68616495085350913",
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 10,
"region": "US",
"sortField": {}
}
}
}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 | Region/market code, e.g., US Example: US |
dateRange | string | optional | Time range, e.g., last7Day, last30Day Example: last30Day |
pageNumber | integer | optional | Rank requests only: page number 1-5; detail requests are unaffected. Finite numeric strings and optional null remain accepted for compatibility. Example: 1 |
pageSize | integer | optional | Rank requests only: items per page 5-100; detail requests are unaffected. Finite numeric strings and optional null remain accepted for compatibility. Example: 10 |
language | string | optional | Return language, e.g., zh-CN, en-US |
currency | string | optional | Currency unit, e.g., USD |
sortField | object | optional | Sort criteria; pass an empty object {} for default rank order when not sorting Example: {} |
category_ids | array | optional | Category ID list filter Example: [] |
shop_id | string | optional | Shop ID filter |
revenue_range | string | optional | Revenue / GMV range filter |
creator_type | string | optional | Creator type filter |
followers_range | string | optional | Follower range filter |
engagement_rate | string | optional | Engagement-rate filter |
creatorId | string | optional | Creator unique ID, e.g., 7153432386608251946, obtainable from the creator_id in the creator rank response Example: 68616495085350913 |
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 | Expert details data, usually a 1-element array when successful |
costToken | integer | optional | The deduction token for this call is usually `14000` |
errmsg | string | optional | Status message, `ok` on success |
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 |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Compare TikTok creators by followers, sales revenue, and region. Focus on the US.
Example Answer
In the published sample, its reported revenue is 604814. Its reported sales volumn is 21290. Its reported revenue growth rate is 7.44. These observations apply only to the shown record and reporting scope.
About this sample: Published documentation excerpt, not a live query. Arrays show at most two records and long text may be shortened. Missing units, dates or coverage remain unspecified; the excerpt does not represent the complete dataset.
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": "US"
}Response
{
"code": 0,
"msg": null,
"data": {
"data": [
{
"revenue_growth_rate": 7.44,
"revenue": 604814,
"video_revenue": 116862,
"sales_volumn": 21290,
"content_views": "63012951",
"creator_followers": "4400000",
"creator_id": "7153432386608251946",
"creator_handle": "@based",
"creator_nickname": "BASED",
"live_revenue": 487952
},
{
"revenue_growth_rate": -49.68,
"revenue": 366565.95,
"video_revenue": 364347.95,
"sales_volumn": 3343,
"content_views": "13488958",
"creator_followers": "234500",
"creator_id": "7147457260049777706",
"creator_handle": "@trending_ttok",
"creator_nickname": "Trending TT",
"live_revenue": 0
},
{
"revenue_growth_rate": -5.28,
"revenue": 343100.92,
"video_revenue": 339466.92,
"sales_volumn": 7084,
"content_views": "21422089",
"creator_followers": "332000",
"creator_id": "6857245188058776581",
"creator_handle": "@myfamilypov",
"creator_nickname": "Josh Morris",
"live_revenue": 0
},
{
"revenue_growth_rate": -35.16,
"revenue": 334938.02,
"video_revenue": 38,
"sales_volumn": 13241,
"content_views": "2577338",
"creator_followers": "872400",
"creator_id": "6800598044448457733",
"creator_handle": "@.brendaayala1",
"creator_nickname": "Brenda Ayala",
"live_revenue": 330199.01
},
{
"revenue_growth_rate": -9.36,
"revenue": 322449.82,
"video_revenue": 46680.16,
"sales_volumn": 1984,
"content_views": "1940096",
"creator_followers": "218400",
"creator_id": "7495995566804714538",
"creator_handle": "@airgeeksrc",
"creator_nickname": "AirGeeksRc",
"live_revenue": 272671.67
},
{
"revenue_growth_rate": -71.31,
"revenue": 248703,
"video_revenue": 99126,
"sales_volumn": 2704,
"content_views": "3530138",
"creator_followers": "521900",
"creator_id": "7179385436960310318",
"creator_handle": "@alondrixsexycurves",
"creator_nickname": "Alondrix sexy curves",
"live_revenue": 146809
},
{
"revenue_growth_rate": -66.54,
"revenue": 223023.9,
"video_revenue": 222115.9,
"sales_volumn": 1608,
"content_views": "6006518",
"creator_followers": "159800",
"creator_id": "7275090345011414059",
"creator_handle": "@dealswithty",
"creator_nickname": "Ty",
"live_revenue": 0
},
{
"revenue_growth_rate": -78.39,
"revenue": 217726.61,
"video_revenue": 126643.43,
"sales_volumn": 2676,
"content_views": "4138969",
"creator_followers": "198200",
"creator_id": "6801519791112897542",
"creator_handle": "@noelyfajas",
"creator_nickname": "Noely Fajas",
"live_revenue": 73958.43
},
{
"revenue_growth_rate": 22.05,
"revenue": 213379.62,
"video_revenue": 209679.58,
"sales_volumn": 8296,
"content_views": "6935085",
"creator_followers": "90500",
"creator_id": "7397634882631861290",
"creator_handle": "@tiktok_shop_christie",
"creator_nickname": "Tiktok Christie",
"live_revenue": 0
},
{
"revenue_growth_rate": -8.67,
"revenue": 213317.76,
"video_revenue": 0,
"sales_volumn": 6908,
"content_views": "1951957",
"creator_followers": "1200000",
"creator_id": "6639149111151607814",
"creator_handle": "@therealmustbecindy",
"creator_nickname": "Mustbecindy",
"live_revenue": 211956.76
},
{
"revenue_growth_rate": -7.99,
"revenue": 202658.1,
"video_revenue": 200681.1,
"sales_volumn": 8426,
"content_views": "20821599",
"creator_followers": "35000",
"creator_id": "7315783616931841066",
"creator_handle": "@honeyquiche",
"creator_nickname": "honeyquiche",
"live_revenue": 0
},
{
"revenue_growth_rate": -40.17,
"revenue": 201463,
"video_revenue": 200595,
"sales_volumn": 6625,
"content_views": "10574268",
"creator_followers": "14300",
"creator_id": "7476529109741536298",
"creator_handle": "@shoppingwithameliarose",
"creator_nickname": "Amelia Rose 🥀",
"live_revenue": 0
},
{
"revenue_growth_rate": -73.27,
"revenue": 200056.83,
"video_revenue": 0,
"sales_volumn": 9087,
"content_views": "1073122",
"creator_followers": "282200",
"creator_id": "7291543591306347562",
"creator_handle": "@highland.fashion7",
"creator_nickname": "Highland Fashion",
"live_revenue": 188813.89
},
{
"revenue_growth_rate": -27.97,
"revenue": 197016.27,
"video_revenue": 194522.32,
"sales_volumn": 8308,
"content_views": "17406928",
"creator_followers": "110600",
"creator_id": "25340095",
"creator_handle": "@lilyy_turcotte",
"creator_nickname": "lily",
"live_revenue": 0
},
{
"revenue_growth_rate": -25.56,
"revenue": 193928.99,
"video_revenue": 192608.99,
"sales_volumn": 3055,
"content_views": "5021978",
"creator_followers": "35200",
"creator_id": "7520310673173316621",
"creator_handle": "@sophmademebuyit",
"creator_nickname": "Soph🦋",
"live_revenue": 0
},
{
"revenue_growth_rate": -38.49,
"revenue": 193793.69,
"video_revenue": 193638.69,
"sales_volumn": 5082,
"content_views": "9060083",
"creator_followers": "46900",
"creator_id": "7509687704070964254",
"creator_handle": "@molly.on.the.mic",
"creator_nickname": "Molly On The Mic",
"live_revenue": 0
},
{
"revenue_growth_rate": -75.34,
"revenue": 185654.98,
"video_revenue": 0,
"sales_volumn": 1565,
"content_views": "825793",
"creator_followers": "470000",
"creator_id": "6906678272890848261",
"creator_handle": "@allpoketcg",
"creator_nickname": "AllPokeTCG",
"live_revenue": 170761.9
},
{
"revenue_growth_rate": -1.53,
"revenue": 183765,
"video_revenue": 183460,
"sales_volumn": 8010,
"content_views": "9392415",
"creator_followers": "50100",
"creator_id": "6900091235630564358",
"creator_handle": "@morganliving",
"creator_nickname": "morganliving",
"live_revenue": 0
},
{
"revenue_growth_rate": -47.96,
"revenue": 179639.07,
"video_revenue": 168896.91,
"sales_volumn": 3721,
"content_views": "9438342",
"creator_followers": "426500",
"creator_id": "6731158605980271622",
"creator_handle": "@luiseltigree",
"creator_nickname": "luiseltigree",
"live_revenue": 0
},
{
"revenue_growth_rate": -80.33,
"revenue": 179238.59,
"video_revenue": 42133.72,
"sales_volumn": 9159,
"content_views": "5632884",
"creator_followers": "8300000",
"creator_id": "6787875411281134598",
"creator_handle": "@jeffreestar",
"creator_nickname": "Jeffree Star",
"live_revenue": 134808.87
}
]
}
}View the MCP Request & Response Format
Examples
Based on a published documentation sample, 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-analytics-example",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_creator_analytics",
"arguments": {
"region": "US"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "tiktok-creator-analytics-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"revenue\":604814,\"sales_volumn\":21290,\"revenue_growth_rate\":7.44,\"video_revenue\":116862,\"content_views\":\"63012951\",\"creator_followers\":\"4400000\",\"creator_id\":\"7153432386608251946\",\"creator_handle\":\"@based\",\"creator_nickname\":\"BASED\",\"live_revenue\":487952},{\"revenue\":366565.95,\"sales_volumn\":3343,\"revenue_growth_rate\":-49.68,\"video_revenue\":364347.95,\"content_views\":\"13488958\",\"creator_followers\":\"234500\",\"creator_id\":\"7147457260049777706\",\"creator_handle\":\"@trending_ttok\",\"creator_nickname\":\"Trending TT\",\"live_revenue\":0}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"revenue": 604814,
"sales_volumn": 21290,
"revenue_growth_rate": 7.44,
"video_revenue": 116862,
"content_views": "63012951",
"creator_followers": "4400000",
"creator_id": "7153432386608251946",
"creator_handle": "@based",
"creator_nickname": "BASED",
"live_revenue": 487952
},
{
"revenue": 366565.95,
"sales_volumn": 3343,
"revenue_growth_rate": -49.68,
"video_revenue": 364347.95,
"content_views": "13488958",
"creator_followers": "234500",
"creator_id": "7147457260049777706",
"creator_handle": "@trending_ttok",
"creator_nickname": "Trending TT",
"live_revenue": 0
}
]
}
},
"isError": false
}
}