TikTok Intelligence KD

TikTok Creator Rankings

Query TikTok creator rankings by region and date range. Call the TikTok Creator Rankings API via REST or MCP from 42 credits per call.

MCP tool name

nexscope_tiktok_creator_search

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize 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 HTTP

Progress 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 Example: {}
`data`	`array`	optional	List or detailed data; real responses do not contain `total` Example: {}
`costToken`	`integer`	optional	The deduction token for this call is usually `14000` Example: {}
`errmsg`	`string`	optional	Status message, `ok` on success Example: {}
`creator_nickname`	`string`	optional	Expert nickname Example: {}
`creator_handle`	`string`	optional	TikTok page name, such as `@based` Example: {}
`creator_id`	`string`	optional	Expert’s unique ID, string format to avoid loss of precision for large integers Example: {}
`creator_followers`	`string`	optional	Number of fans, returned as a string Example: {}
`content_views`	`string`	optional	The total number of views of the content, returned as a string Example: {}
`sales_volumn`	`integer`	optional	Sales volume, field spelled `volumn` Example: {}
`revenue`	`number`	optional	Total sales/GMV, returned by requested `currency` Example: {}
`video_revenue`	`number`	optional	Short video sales Example: {}
`live_revenue`	`number`	optional	Live streaming sales Example: {}
`revenue_growth_rate`	`number`	optional	Sales growth rate (%), can be positive or negative Example: {}
`creator_id`	`string`	optional	Master's unique ID Example: {}
`creator_nickname`	`string`	optional	Expert nickname Example: {}
`creator_handle`	`string`	optional	Expert handle Example: {}
`creator_region`	`string`	optional	Expert area Example: {}
`creator_status`	`string`	optional	Master status Example: {}
`creator_bio`	`string`	optional	Profile of the expert Example: {}
`creator_belonged_shop_id`	`string`	optional	Store ID Example: {}
`creator_followers`	`string`	optional	Total number of fans, returned as a string Example: {}
`new_followers`	`integer`	optional	Add new fans in `dateRange` window Example: {}
`revenue`	`number`	optional	Total Sales/GMV Example: {}
`video_revenue`	`number`	optional	video sales Example: {}
`live_revenue`	`number`	optional	Live sales Example: {}
`sales_volumn`	`integer`	optional	Sales volume, field spelled `volumn` Example: {}
`unit_price`	`number`	optional	unit price Example: {}
`video_number`	`integer`	optional	Number of videos in the window Example: {}
`video_views`	`integer`	optional	Total video views Example: {}
`video_gpm`	`number`	optional	Video GPM Example: {}
`live_number`	`integer`	optional	Number of live broadcasts within the window Example: {}
`live_views`	`integer`	optional	Total live views Example: {}
`live_gpm`	`number`	optional	Live GPM Example: {}
`product_number`	`integer`	optional	Number of related products Example: {}
`shop_number`	`integer`	optional	Number of associated stores Example: {}
`creator_contact_email`	`string`	optional	Contact email Example: {}
`creator_contact_ins`	`string`	optional	Instagram Contact Example: {}
`creator_contact_whatsapp`	`string`	optional	WhatsApp Contact Example: {}
`creator_contact_facebook`	`string`	optional	Facebook Contact Example: {}
`creator_contact_tiktok`	`string`	optional	TikTok contact information Example: {}
`creator_contact_zalo`	`string`	optional	Contact Us Example: {}
`creator_contact_line`	`string`	optional	Line contact information Example: {}

Examples

Example arguments

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

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}