TikTok Intelligence KD

TikTok Intelligence KD: creator/rank API

TikTok Intelligence KD: creator/rank API.

MCP tool name

nexscope_data_kd_creator_rank

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": "data-kd-creator-rank-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_kd_creator_rank",
    "arguments": {
      "currency": "USD",
      "dateRange": "last7Day",
      "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	Region/market code, such as `US` Example: {}
`dateRange`	`string`	optional	Time range, such as `last7Day`, `last30Day` Example: {}
`pageNumber`	`integer`	optional	Page number, value 1-5 Example: {}
`pageSize`	`integer`	optional	Quantity per page, value 5-100 Example: {}
`language`	`string`	optional	Return language, for example `zh-CN`, `en-US` Example: {}
`currency`	`string`	optional	Currency unit, such as `USD` Example: {}
`category_ids`	`integer[]`	optional	Category ID list filter Example: {}
`shop_id`	`string`	optional	Store ID filter Example: {}
`revenue_range`	`string`	optional	Transaction amount/GMV range filter Example: {}
`creator_type`	`string`	optional	Expert type filtering Example: {}
`followers_range`	`string`	optional	Filter by fan count range Example: {}
`engagement_rate`	`string`	optional	Interaction rate filter Example: {}
`sortField`	`object`	optional	Sorting conditions; when not sorting, pass the empty object `{}`. The available sorting fields are subject to those actually accepted by the gateway. Example: {}
`creatorId`	`string`	required	The unique ID of the expert, such as `7153432386608251946`, can be obtained from the `creator_id` of the list response 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

{
  "currency": "USD",
  "dateRange": "last7Day",
  "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"
}