TikTok Intelligence ET

TikTok Intelligence ET: list Video API

TikTok Intelligence ET: list Video API.

MCP tool name

nexscope_data_et_list_video

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-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_et_list_video",
    "arguments": {
      "pageNum": 1,
      "pageSize": 20,
      "region": "US",
      "sortType": 1,
      "videoSortField": 3
    }
  }
}

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`	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: {}
`userId`	`string`	optional	Expert ID filtering. Maximum length 1000 Example: {}
`productId`	`string`	optional	Product ID associated with the video. Maximum length 1000 Example: {}
`productCategoryId`	`string`	optional	Associated product category ID. Maximum length 1000 Example: {}
`minTotalViewsCnt`	`integer`	optional	Video playback filter (minimum value) Example: {}
`maxTotalViewsCnt`	`integer`	optional	Video playback filter (maximum value) Example: {}
`minDuration`	`integer`	optional	Video duration range filtering (seconds) - minimum value Example: {}
`maxDuration`	`integer`	optional	Video duration range filtering (seconds) - maximum value Example: {}
`minCreateTime`	`integer`	optional	Release time range filtering (second-level timestamp)-minimum value Example: {}
`maxCreateTime`	`integer`	optional	Release time range filtering (second-level timestamp) - maximum value Example: {}
`salesFlag`	`integer`	optional	Whether to bring goods video: 0 = no goods carrying video, 1 = goods carrying video Example: {}
`isAd`	`integer`	optional	Whether to stream video: 0 = no streaming video, 1 = streaming video Example: {}
`createdByAi`	`string`	optional	Whether AI video, only accepts the string `"true"` (AI video) or `"false"` (non-AI video), non-Boolean Example: {}
`videoSortField`	`integer`	optional	Sorting fields: 1=total_digg_cnt (number of likes), 2=create_time (release time), 3=total_views_cnt (number of views) Example: 3
`sortType`	`integer`	optional	Sorting method: 0=ascending order (asc), 1=descending order (desc) Example: 1
`pageNum`	`integer`	optional	Pagination page number, starting from 1 Example: 1
`pageSize`	`integer`	optional	Number of items per page. Must be a multiple of 10, the maximum is 100; the upper limit for a single page of the third-party interface is 10, internally press 10 for each page to be pulled multiple times 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	Video list (see video field below for details) Example: {}
`columns`	`array`	optional	Rendered columns Example: {}
`type`	`string`	optional	Rendering style Example: {}
`costToken`	`integer`	optional	Consume token Example: {}
`videoId`	`string`	optional	Video ID Example: {}
`videoDesc`	`string`	optional	Video description Example: {}
`officialUrl`	`string`	optional	TikTok official video address Example: {}
`coverUrl`	`string`	optional	Video cover URL Example: {}
`duration`	`integer`	optional	Video duration (seconds) Example: {}
`width`	`string`	optional	video width Example: {}
`height`	`string`	optional	video height Example: {}
`ratio`	`string`	optional	Video clarity (resolution, such as 540p/720p) Example: {}
`dataSize`	`string`	optional	Video file size Example: {}
`createDate`	`string`	optional	Video release date Example: {}
`userId`	`string`	optional	Expert ID Example: {}
`uniqueId`	`string`	optional	TikTok account ID (unique_id) Example: {}
`avatar`	`string`	optional	Master avatar Example: {}
`totalViewsCnt`	`integer`	optional	Total views Example: {}
`totalViews1dCnt`	`integer`	optional	Play volume in the past day Example: {}
`totalViews7dCnt`	`integer`	optional	Play volume in the past 7 days Example: {}
`totalViews30dCnt`	`integer`	optional	Play volume in the past 30 days Example: {}
`totalDiggCnt`	`integer`	optional	Total likes Example: {}
`totalDigg1dCnt`	`integer`	optional	Number of likes in the past day Example: {}
`totalDigg7dCnt`	`integer`	optional	Number of likes in the past 7 days Example: {}
`totalDigg30dCnt`	`integer`	optional	Number of likes in the past 30 days Example: {}
`totalCommentsCnt`	`integer`	optional	Total comments Example: {}
`totalSharesCnt`	`integer`	optional	Total shares Example: {}
`totalFavoritesCnt`	`integer`	optional	Total collections Example: {}
`totalVideoSaleCnt`	`integer`	optional	Video sales (number of pieces) Example: {}
`totalVideoSaleGmvAmt`	`integer`	optional	Video sales GMV (amount) Example: {}
`salesFlagText`	`string`	optional	Whether to bring goods video Example: {}
`isAdText`	`string`	optional	Whether to stream video Example: {}
`createdByAiText`	`string`	optional	Whether AI video (yes/no/unknown) Example: {}
`productCategoryList`	`string`	optional	Product classification Example: {}
`videoProducts`	`string`	optional	Video related products Example: {}
`region`	`string`	optional	area code Example: {}
`sourceType`	`string`	optional	Product source Example: {}

Examples

Example arguments

{
  "pageNum": 1,
  "pageSize": 20,
  "region": "US",
  "sortType": 1,
  "videoSortField": 3
}

Example structuredContent

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