Nexscope
Start free

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
Equivalent REST API path
https://api.nexscope.ai/api/skill-api/v1/skills/tiktok-video-rank/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-video-rank-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_video_rank",
    "arguments": {
      "date": "2026-08-26",
      "pageSize": 10,
      "rankType": 1,
      "videoRankField": 1,
      "region": "US",
      "pageNum": 1
    }
  }
}
REST API equivalent
POST https://api.nexscope.ai/api/skill-api/v1/skills/tiktok-video-rank/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/tiktok-video-rank

Arguments

NameTypeRequiredMeaning
datestringrequired
Ranking date in YYYY-MM-DD format
Example: 2026-08-26
rankTypeintegerrequired
Ranking type: 1, 2, or 3
Example: 1
regionstringrequired
TikTok market region code
Example: US
videoRankFieldintegerrequired
Video ranking field: 1 or 2
Example: 1
productCategoryIdstringoptional
Optional product category ID
Example: {}
createdByAistringoptional
Filter AI-created videos using the string true or false
Example: {}
pageNumintegeroptional
Page number, starting at 1
Example: 1
pageSizeintegeroptional
Page size from 10 to 100 in multiples of 10
Example: 10

Response fields

Treat structuredContent as the programmatic API response payload.

No response field schema is defined for this tool.

Examples

Example arguments

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

Example structuredContent

{
  "videos": [
    {
      "region": "US",
      "totalViewsCnt": 1,
      "videoId": "example-video-id"
    }
  ],
  "total": 1
}