TikTok / Social Commerce

TikTok Video Search MCP Tool

Search and analyze TikTok video data, filter videos by region, creator, product, category, views, duration, publish time, selling/ad/AI video flags, and return views, likes, comments, shares, favorites, video sales and GMV metrics across 16 TikTok Shop sites.

MCP tool name
nexscope_tiktok_video_search
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/tiktok-video-search/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-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_video_search",
    "arguments": {
      "region": "US",
      "pageSize": 10,
      "keyword": "phone case",
      "pageNumber": 1
    }
  }
}
REST API equivalent
POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/tiktok-video-search/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/tiktok-video-search

Arguments

NameTypeRequiredMeaning
regionstringrequired
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
userIdstringoptional
Creator ID filter. Max length 1000
Example: example-id
productIdstringoptional
Associated product ID. Max length 1000
Example: {}
productCategoryIdstringoptional
Associated product category ID. Max length 1000
Example: example-id
minTotalViewsCntintegeroptional
Video view count filter (minimum)
Example: 1
maxTotalViewsCntintegeroptional
Video view count filter (maximum)
Example: 1
minDurationintegeroptional
Video duration range filter (seconds) - minimum
Example: 1
maxDurationintegeroptional
Video duration range filter (seconds) - maximum
Example: 1
minCreateTimeintegeroptional
Publish time range filter (seconds-level timestamp) - minimum
Example: 1
maxCreateTimeintegeroptional
Publish time range filter (seconds-level timestamp) - maximum
Example: 1
salesFlagintegeroptional
Whether a promotional video: 0=non-promotional video, 1=promotional video
Example: 1
isAdintegeroptional
Whether an ad video: 0=non-ad video, 1=ad video
Example: 1
createdByAistringoptional
Whether AI video, string "true"=AI video, "false"=non-AI video (regex ^(true
Example: {}
videoSortFieldintegeroptional
Sort field: 1=total_digg_cnt (likes), 2=create_time (publish time), 3=total_views_cnt (views)
Example: 1
sortTypeintegeroptional
Sort direction: 0=ascending, 1=descending
Example: 1
pageNumintegeroptional
Page number, starting from 1
Example: 1
pageSizeintegeroptional
Items per page. 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: 10

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
errcodeintegeroptional
Business status code, 200 indicates success (see error codes below)
Example: 1
errmsgstringoptional
Business status description
Example: {}
totalintegeroptional
Record count
Example: 1
dataarrayoptional
Video list (see video fields below)
Example: []
columnsarrayoptional
Rendered columns
Example: []
typestringoptional
Render style
Example: {}
costTokenintegeroptional
Token cost
Example: 1
columns[].videoIdstringoptional
Video ID
Example: example-id
columns[].videoDescstringoptional
Video description
Example: {}
columns[].officialUrlstringoptional
TikTok official video URL
Example: https://example.com/image.jpg
columns[].coverUrlstringoptional
Video cover URL
Example: https://example.com/image.jpg
columns[].durationintegeroptional
Video duration (seconds)
Example: 1
columns[].widthstringoptional
Video width
Example: {}
columns[].heightstringoptional
Video height
Example: {}
columns[].ratiostringoptional
Video resolution (e.g., 540p/720p)
Example: {}
columns[].dataSizestringoptional
Video file size
Example: {}
columns[].createDatestringoptional
Video publish date
Example: 2026-01-01
columns[].userIdstringoptional
Creator ID
Example: example-id
columns[].uniqueIdstringoptional
TikTok account ID (unique_id)
Example: example-id
columns[].avatarstringoptional
Creator avatar
Example: {}
columns[].totalViewsCntintegeroptional
Total view count
Example: 1
columns[].totalViews1dCntintegeroptional
Views in last 1 day
Example: 1
columns[].totalViews7dCntintegeroptional
Views in last 7 days
Example: 1
columns[].totalViews30dCntintegeroptional
Views in last 30 days
Example: 1
columns[].totalDiggCntintegeroptional
Total like count
Example: 1
columns[].totalDigg1dCntintegeroptional
Likes in last 1 day
Example: 1
columns[].totalDigg7dCntintegeroptional
Likes in last 7 days
Example: 1
columns[].totalDigg30dCntintegeroptional
Likes in last 30 days
Example: 1
columns[].totalCommentsCntintegeroptional
Total comment count
Example: 1
columns[].totalSharesCntintegeroptional
Total share count
Example: 1
columns[].totalFavoritesCntintegeroptional
Total favorite count
Example: 1
columns[].totalVideoSaleCntintegeroptional
Video sales (units)
Example: 1
columns[].totalVideoSaleGmvAmtintegeroptional
Video sales GMV (amount)
Example: 1
columns[].salesFlagTextstringoptional
Whether promotional video
Example: {}
columns[].isAdTextstringoptional
Whether ad video
Example: {}
columns[].createdByAiTextstringoptional
Whether AI video (Yes/No/Unknown)
Example: {}
columns[].productCategoryListstringoptional
Product categories
Example: {}
columns[].videoProductsstringoptional
Video associated products
Example: {}
columns[].regionstringoptional
Region code
Example: US
columns[].sourceTypestringoptional
Product source
Example: {}
columns[].sourceToolstringoptional
Source tool
Example: {}
codestringoptional
Provider-specific status code.
Example: {}
msgstringoptional
Provider-specific status message.
Example: {}
messagestringoptional
Provider-specific message.
Example: {}
titlestringoptional
Provider-specific response title.
Example: {}
sourceTypestringoptional
Provider-specific source platform type.
Example: {}
sourceToolstringoptional
Provider-specific source tool name.
Example: {}
costTimeintegeroptional
Execution time reported by the upstream provider.
Example: {}
pageintegeroptional
Current page returned by the upstream provider.
Example: {}
pageSizeintegeroptional
Page size returned by the upstream provider.
Example: {}
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: {}
totalPageintegeroptional
Total page count returned by the upstream provider.
Example: {}
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: {}

Examples

Example arguments

{
  "region": "US",
  "pageSize": 10,
  "keyword": "phone case",
  "pageNumber": 1
}

Example structuredContent

{
  "errcode": 1,
  "total": 1,
  "data": [],
  "columns": [
    {
      "videoId": "example-id",
      "officialUrl": "https://example.com/image.jpg",
      "coverUrl": "https://example.com/image.jpg",
      "duration": 1,
      "createDate": "2026-01-01",
      "userId": "example-id",
      "uniqueId": "example-id",
      "totalViewsCnt": 1,
      "totalViews1dCnt": 1,
      "totalViews7dCnt": 1,
      "totalViews30dCnt": 1,
      "totalDiggCnt": 1,
      "totalDigg1dCnt": 1,
      "totalDigg7dCnt": 1,
      "totalDigg30dCnt": 1,
      "totalCommentsCnt": 1,
      "totalSharesCnt": 1,
      "totalFavoritesCnt": 1,
      "totalVideoSaleCnt": 1,
      "totalVideoSaleGmvAmt": 1,
      "region": "US"
    }
  ],
  "costToken": 1
}