TikTok / Social Commerce

TikTok Video Rank MCP Tool

Returns normalized public ecommerce research data with a fixed read-only provider path.

MCP tool name

nexscope_tiktok_video_rank

Legacy MCP endpoint

/api/skill-api/v1/mcp

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-video-rank-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_video_rank",
    "arguments": {
      "videoRankField": 1,
      "region": "US",
      "pageNum": 1,
      "date": "2026-08-26",
      "pageSize": 10,
      "rankType": 1
    }
  }
}

Legacy endpoint

POST /api/skill-api/v1/mcp

Canonical detail URL

https://www.nexscope.ai/mcp-map/tiktok-video-rank

Arguments

Name	Type	Required	Meaning
`date`	`string`	required	Ranking date in YYYY-MM-DD format Example: 2026-08-26
`rankType`	`integer`	required	Ranking type: 1, 2, or 3 Example: 1
`region`	`string`	required	TikTok market region code Example: US
`videoRankField`	`integer`	required	Video ranking field: 1 or 2 Example: 1
`productCategoryId`	`string`	optional	Optional product category ID Example: {}
`createdByAi`	`string`	optional	Filter AI-created videos using the string true or false Example: {}
`pageNum`	`integer`	optional	Page number, starting at 1 Example: 1
`pageSize`	`integer`	optional	Page size from 10 to 100 in multiples of 10 Example: 10

Response fields

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.

Any of option 1 — requires videos, total

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.videos`	`array`	required	Videos value used by this API operation.
`data.videos[]`	`object`	required	Item in data videos.
`data.videos[].videoId`	`string`	optional	Video id value used by this API operation.
`data.videos[].officialUrl`	`string`	optional	Official url value used by this API operation.
`data.videos[].region`	`string`	optional	Region value used by this API operation.
`data.videos[].totalViewsCnt`	`integer \| number`	optional	Total views cnt value used by this API operation.
`data.total`	`integer`	required	Total value used by this API operation. Minimum: 0

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

Examples

Example arguments

{
  "videoRankField": 1,
  "region": "US",
  "pageNum": 1,
  "date": "2026-08-26",
  "pageSize": 10,
  "rankType": 1
}

Example structuredContent

{
  "data": {
    "total": 1,
    "videos": [
      {
        "videoId": "example-video-id",
        "region": "US",
        "totalViewsCnt": 1
      }
    ]
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}