TikTok / Social Commerce

TikTok Creator Search MCP Tool

Queries Kalodata creator rankings by region and date range.

MCP tool name
nexscope_tiktok_creator_search
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/tiktok-creator-search/run
JSON-RPC method
tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

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"
    }
  }
}
REST API equivalent
POST https://claw-callback.nexscope.ai/api/skill-api/v1/skills/tiktok-creator-search/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/tiktok-creator-search

Arguments

NameTypeRequiredMeaning
regionstringoptional
Optional TikTok Shop market region.
Example: US
dateRangestringoptional
Relative date range.
Example: last30Day
pageNumberintegeroptional
Page number.
Example: 1
pageSizeintegeroptional
Rows per page.
Example: 10
currencystringoptional
Currency code.
Example: USD
languagestringoptional
Response language.
Example: en-US
sortFieldobjectoptional
Optional provider sort object.
Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
dataarrayoptional
Creator ranking rows.
Example: []
data[].creator_idstringoptional
TikTok creator ID.
Example: 68616495085350913
data[].creator_nicknamestringoptional
Creator nickname.
Example: Example creator
data[].creator_handlestringoptional
TikTok handle.
Example: @creator
data[].creator_followersstringoptional
Follower count returned as a string.
Example: 100000
data[].content_viewsstringoptional
Content views returned as a string.
Example: 1000000
data[].sales_volumnintegeroptional
Estimated sales volume (provider spelling).
Example: 100
data[].revenuenumberoptional
Estimated creator GMV.
Example: 1000
data[].video_revenuenumberoptional
Short-video revenue.
Example: 600
data[].live_revenuenumberoptional
Livestream revenue.
Example: 400
data[].revenue_growth_ratenumberoptional
Revenue growth percentage.
Example: 12.5
data[].creator_regionstringoptional
Creator region.
Example: US
data[].creator_statusstringoptional
Creator status.
Example: active
data[].new_followersintegeroptional
New followers in the selected window.
Example: 1000
data[].video_numberintegeroptional
Video count.
Example: 20
data[].live_numberintegeroptional
Livestream count.
Example: 5
data[].product_numberintegeroptional
Associated product count.
Example: 10
data[].shop_numberintegeroptional
Associated shop count.
Example: 3
errcodeintegeroptional
Upstream status code returned by the provider.
Example: {}
errmsgstringoptional
Upstream status message returned by the provider.
Example: {}
codestringoptional
Provider-specific status code.
Example: {}
msgstringoptional
Provider-specific status message.
Example: {}
messagestringoptional
Provider-specific message.
Example: {}
typestringoptional
Provider-specific render or payload type.
Example: {}
titlestringoptional
Provider-specific response title.
Example: {}
sourceTypestringoptional
Provider-specific source platform type.
Example: {}
sourceToolstringoptional
Provider-specific source tool name.
Example: {}
costTokenintegeroptional
Token cost reported by the upstream provider.
Example: {}
costTimeintegeroptional
Execution time reported by the upstream provider.
Example: {}
pageintegeroptional
Current page returned by the upstream provider.
Example: {}
pageSizeintegeroptional
Page size returned by the upstream provider.
Example: {}
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: {}
totalPageintegeroptional
Total page count returned by the upstream provider.
Example: {}
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: {}

Examples

Example arguments

{
  "dateRange": "last30Day",
  "pageNumber": 1,
  "pageSize": 10,
  "region": "US"
}

Example structuredContent

{
  "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
    }
  ]
}