TikTok Intelligence ET

TikTok Video Search

Find TikTok videos by product, creator, region, engagement, and sales performance. Call the TikTok Video Search API via REST or MCP from 10 credits per call.

MCP tool name

nexscope_tiktok_video_search

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-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_video_search",
    "arguments": {
      "pageNum": 1,
      "pageSize": 50,
      "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	Region code. Options: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France) Example: US
`userId`	`string`	optional	Creator ID filter. Max length 1000 Example: example-id
`productId`	`string`	optional	Associated product ID. Max length 1000 Example: {}
`productCategoryId`	`string`	optional	Associated product category ID. Max length 1000 Example: example-id
`minTotalViewsCnt`	`integer`	optional	Video view count filter (minimum) Example: 1
`maxTotalViewsCnt`	`integer`	optional	Video view count filter (maximum) Example: 1
`minDuration`	`integer`	optional	Video duration range filter (seconds) - minimum Example: 1
`maxDuration`	`integer`	optional	Video duration range filter (seconds) - maximum Example: 1
`minCreateTime`	`integer`	optional	Publish time range filter (seconds-level timestamp) - minimum Example: 1
`maxCreateTime`	`integer`	optional	Publish time range filter (seconds-level timestamp) - maximum Example: 1
`salesFlag`	`integer`	optional	Whether a promotional video: 0=non-promotional video, 1=promotional video Example: 1
`isAd`	`integer`	optional	Whether an ad video: 0=non-ad video, 1=ad video Example: 1
`createdByAi`	`string`	optional	AI video filter; accepts only the strings "true" or "false", not a JSON boolean Example: {}
`videoSortField`	`integer`	optional	Sort field, default 3: 1=total_digg_cnt (likes), 2=create_time (publish time), 3=total_views_cnt (views) Example: 3
`sortType`	`integer`	optional	Sort direction: 0=ascending, 1=descending Example: 1
`pageNum`	`integer`	optional	Page number, starting from 1 Example: 1
`pageSize`	`integer`	optional	Items per page, default 50. Must be a multiple of 10, max 100; the third-party API limit is 10 per page, internally the gateway fetches 10 per page in multiple rounds and merges 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": 50,
  "region": "US",
  "sortType": 1,
  "videoSortField": 3
}

Example structuredContent

{}