TikTok Shop
TikTok Creator Rankings
Search TikTok ecommerce creator rankings.
MCP tool name
nexscope_tiktok_creator_searchMCP endpoint
https://api.nexscope.ai/api/skill-api/v2/mcpJSON-RPC method
tools/callTikTok Shop
Search TikTok ecommerce creator rankings.
nexscope_tiktok_creator_searchhttps://api.nexscope.ai/api/skill-api/v2/mcptools/callUse OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope for standard remote clients. API keys remain supported as a compatibility option while v1 integrations migrate.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.
Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/api/skill-api/v2/mcp, then use tools/call with the MCP tool name below. The arguments object should match the table on this page.
{
"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 HTTPhttps://www.nexscope.ai/mcp-map/tiktok-creator-searchProgress is delivered on the original POST SSE response when the client supplies a progress token and the tool has real execution stages. GET SSE carries server notifications such as tool-list changes. Creating an asynchronous task or calling an external provider may consume credits; reconnecting must query the existing task instead of submitting it again.
| 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: {} |
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.data | array | optional | Creator ranking rows. Example: [] |
data.data[] | object | required | Item in data data. |
data.data[].creator_id | string | optional | TikTok creator ID. Example: 68616495085350913 |
data.data[].creator_nickname | string | optional |
{
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 10,
"region": "US"
}{
"data": {
"data": [
{
"creator_id": "68616495085350913",
"creator_nickname": "Example creator",
"creator_handle": "@creator",
"creator_followers": "100000",
"content_views": "1000000",
"sales_volumn": 100,
"revenue": 1000,
"video_revenue": 600,
"live_revenue": 400,
"revenue_growth_rate": 12.5,
"creator_region": "US",
"creator_status": "active",
"new_followers": 1000,
"video_number": 20,
"live_number": 5,
"product_number": 10,
"shop_number": 3
}
]
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}Creator nickname. Example: Example creator |
data.data[].creator_handle | string | optional | TikTok handle. Example: @creator |
data.data[].creator_followers | string | optional | Follower count returned as a string. Example: 100000 |
data.data[].content_views | string | optional | Content views returned as a string. Example: 1000000 |
data.data[].sales_volumn | integer | optional | Estimated sales volume (provider spelling). Example: 100 |
data.data[].revenue | number | optional | Estimated creator GMV. Example: 1000 |
data.data[].video_revenue | number | optional | Short-video revenue. Example: 600 |
data.data[].live_revenue | number | optional | Livestream revenue. Example: 400 |
data.data[].revenue_growth_rate | number | optional | Revenue growth percentage. Example: 12.5 |
data.data[].creator_region | string | optional | Creator region. Example: US |
data.data[].creator_status | string | optional | Creator status. Example: active |
data.data[].new_followers | integer | optional | New followers in the selected window. Example: 1000 |
data.data[].video_number | integer | optional | Video count. Example: 20 |
data.data[].live_number | integer | optional | Livestream count. Example: 5 |
data.data[].product_number | integer | optional | Associated product count. Example: 10 |
data.data[].shop_number | integer | optional | Associated shop count. Example: 3 |
data.type | string | optional | Provider-specific render or payload type. Example: null |
data.title | string | optional | Provider-specific response title. Example: null |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.costToken | integer | optional | Token cost reported by the upstream provider. Example: null |
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |