TikTok Shop
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.
nexscope_tiktok_video_search/api/skill-api/v1/mcptools/callSend the user API key as a bearer token on every MCP JSON-RPC request.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this 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": {
"sortType": 1,
"pageNum": 1,
"region": "US",
"videoSortField": 3,
"pageSize": 50
}
}
}POST /api/skill-api/v1/mcphttps://www.nexscope.ai/mcp-map/tiktok-video-search| 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 |
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.total | integer | optional | Record count Example: 1 |
data.data | array | optional | Video list (see video fields below) Example: [] |
data.data[] | object | required | Item in data data. |
data.data[].videoId | string | optional |
{
"sortType": 1,
"pageNum": 1,
"region": "US",
"videoSortField": 3,
"pageSize": 50
}{
"data": {
"total": 1,
"data": [
{
"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"
}
],
"columns": [],
"costToken": 1
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}data.data[].videoDesc | string | optional | Video description Example: null |
data.data[].officialUrl | string | optional | TikTok official video URL Example: https://example.com/image.jpg |
data.data[].coverUrl | string | optional | Video cover URL Example: https://example.com/image.jpg |
data.data[].duration | integer | optional | Video duration (seconds) Example: 1 |
data.data[].width | string | optional | Video width Example: null |
data.data[].height | string | optional | Video height Example: null |
data.data[].ratio | string | optional | Video resolution (e.g., 540p/720p) Example: null |
data.data[].dataSize | string | optional | Video file size Example: null |
data.data[].createDate | string | optional | Video publish date Example: 2026-01-01 |
data.data[].userId | string | optional | Creator ID Example: example-id |
data.data[].uniqueId | string | optional | TikTok account ID (unique_id) Example: example-id |
data.data[].avatar | string | optional | Creator avatar Example: null |
data.data[].totalViewsCnt | integer | optional | Total view count Example: 1 |
data.data[].totalViews1dCnt | integer | optional | Views in last 1 day Example: 1 |
data.data[].totalViews7dCnt | integer | optional | Views in last 7 days Example: 1 |
data.data[].totalViews30dCnt | integer | optional | Views in last 30 days Example: 1 |
data.data[].totalDiggCnt | integer | optional | Total like count Example: 1 |
data.data[].totalDigg1dCnt | integer | optional | Likes in last 1 day Example: 1 |
data.data[].totalDigg7dCnt | integer | optional | Likes in last 7 days Example: 1 |
data.data[].totalDigg30dCnt | integer | optional | Likes in last 30 days Example: 1 |
data.data[].totalCommentsCnt | integer | optional | Total comment count Example: 1 |
data.data[].totalSharesCnt | integer | optional | Total share count Example: 1 |
data.data[].totalFavoritesCnt | integer | optional | Total favorite count Example: 1 |
data.data[].totalVideoSaleCnt | integer | optional | Video sales (units) Example: 1 |
data.data[].totalVideoSaleGmvAmt | integer | optional | Video sales GMV (amount) Example: 1 |
data.data[].salesFlagText | string | optional | Whether promotional video Example: null |
data.data[].isAdText | string | optional | Whether ad video Example: null |
data.data[].createdByAiText | string | optional | Whether AI video (Yes/No/Unknown) Example: null |
data.data[].productCategoryList | string | optional | Product categories Example: null |
data.data[].videoProducts | string | optional | Video associated products Example: null |
data.data[].region | string | optional | Region code Example: US |
data.data[].sourceType | string | optional | Product source Example: null |
data.data[].sourceTool | string | optional | Source tool Example: null |
data.columns | array | optional | Rendered columns Example: [] |
data.type | string | optional | Render style Example: null |
data.costToken | integer | optional | Token cost Example: 1 |
data.title | string | optional | Provider-specific response title. Example: null |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |