TikTok Intelligence ET

TikTok Intelligence ET: list Video Rank API

TikTok Intelligence ET: list Video Rank API.

MCP tool name

nexscope_data_et_list_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": "data-et-list-video-rank-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_et_list_video_rank",
    "arguments": {
      "date": "2026-08-10",
      "pageNum": 1,
      "pageSize": 20,
      "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	List query date, format `YYYY-MM-DD` Example: {}
`rankType`	`integer`	required	List type: `1` = daily list, `2` = weekly list, `3` = monthly list Example: {}
`region`	`string`	required	Area code. Optional values: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (UK), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France) Example: {}
`videoRankField`	`integer`	required	Video ranking metrics: `1` = Ranking by views, `2` = Ranking by video sales Example: {}
`productCategoryId`	`string`	optional	Product first-level category ID, used to filter product categories in the product video list Example: {}
`createdByAi`	`string`	optional	Whether AI video, optional string `true` / `false` Example: {}
`pageNum`	`integer`	optional	Pagination page number, starting from 1 Example: 1
`pageSize`	`integer`	optional	Number of items per page. It must be a multiple of 10, with a maximum of 100; the upper limit of a single page in the official interface is 10, and internally it is 10 after multiple pulls per page and then merged 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-10",
  "pageNum": 1,
  "pageSize": 20,
  "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"
}