TikTok Intelligence ET

TikTok Video Rank

Rank public TikTok ecommerce videos by supported market, date, category, and performance filters with paginated result totals. Call it via REST API or MCP.

MCP tool name

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

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
`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; default 50 Example: 50

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`errcode`	`integer`	optional	Business status code, 200 indicates success (see error code below for details) Example: {}
`errmsg`	`string`	optional	Business status description Example: {}
`total`	`integer`	optional	Number of records Example: {}
`data`	`array`	optional	List of videos, sorted by `videoRankField` (see video field below for details) Example: {}
`columns`	`array`	optional	Rendered columns (front-end rendering metadata, the length may be greater than `data`, please refer to `data` for data retrieval) Example: {}
`type`	`string`	optional	Rendering style Example: {}
`costToken`	`integer`	optional	Consume token Example: {}
`videoId`	`string`	optional	Video ID Example: {}
`officialUrl`	`string`	optional	TikTok official video address Example: {}
`userId`	`string`	optional	Expert ID Example: {}
`uniqueId`	`string`	optional	TikTok account ID Example: {}
`nickName`	`string`	optional	Expert nickname Example: {}
`avatar`	`string`	optional	Master avatar Example: {}
`category`	`string`	optional	Expert classification Example: {}
`videoDesc`	`string`	optional	Video description Example: {}
`createDate`	`string`	optional	Video release date Example: {}
`coverUrl`	`string`	optional	Video cover URL Example: {}
`region`	`string`	optional	area code Example: {}
`duration`	`integer`	optional	Video duration (seconds) Example: {}
`createdByAiText`	`string`	optional	AI video or not (yes/no) Example: {}
`salesFlagText`	`string`	optional	Whether to bring goods video (yes/no) Example: {}
`productCategoryList`	`string`	optional	Cargo product classification Example: {}
`videoProducts`	`string`	optional	Video products Example: {}
`totalCommentsCnt`	`integer`	optional	Number of comments per cycle Example: {}
`totalDiggCnt`	`integer`	optional	Number of likes per cycle Example: {}
`totalFavoritesCnt`	`integer`	optional	Number of cycle collections Example: {}
`totalSharesCnt`	`integer`	optional	Number of cycles shared Example: {}
`totalViewsCnt`	`integer`	optional	Cycle play volume Example: {}
`totalVideoSaleCnt`	`integer`	optional	Periodic video sales (estimated) Example: {}
`totalVideoSaleGmvAmt`	`number`	optional	Cycle video sales GMV (estimate) Example: {}
`sourceType`	`string`	optional	Product source Example: {}

Examples

Example arguments

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

Example structuredContent

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