TikTok Intelligence ET
TikTok Video Details in Bulk MCP
Retrieve details for several TikTok videos in one request to compare their content and available performance information.
TikTok Video Details in Bulk AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Compare The Available Details Of Several TikTok Videos
Prompt: Compare the available details of several TikTok videos for [video IDs]. Show the available results and clearly identify missing information.
2. Compare The Available Details Of Several TikTok Videos By Video Links
Prompt: Compare the available details of several TikTok videos using [video links]. Keep the returned results tied to that input and do not infer matches that were not returned.
3. Compare Video Performance Windows
Prompt: Compare the available details of several TikTok videos for [video IDs]. Show the available results and clearly identify missing information. Compare views and likes separately for the returned one-day, seven-day and 30-day windows. Do not add overlapping windows or infer growth from unequal durations.
4. Review Commerce And Advertising Labels
Prompt: Compare the available details of several TikTok videos for [video IDs]. Show the available results and clearly identify missing information. Show returned product links, sale count and GMV together with advertising and AI-created labels. Do not infer a causal ad effect or net income.
5. Plan Reuse From Video Dimensions
Prompt: Compare the available details of several TikTok videos for [video IDs]. Show the available results and clearly identify missing information. Inventory duration, width, height, aspect ratio and official URL for each returned video. Flag unavailable technical data; do not assume reuse rights or edit the videos.
6. Combine Known Video IDs And Links
Prompt: Retrieve details for [up to 1,000 video IDs] together with [up to 1,000 full TikTok video URLs]. Let the tool merge the extracted IDs and keep returned identities visible. Do not assume duplicate inputs produce distinct videos or that unreturned IDs are valid.
What You Need to Provide
Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.
Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.
Use at most 1,000 IDs and at most 1,000 full TikTok video URLs. IDs and URLs can be supplied together; they are merged, not mutually exclusive.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_data_et_batch_video_detailhttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "data-et-batch-video-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_et_batch_video_detail",
"arguments": {
"videoIds": [
"7030893014180531462",
"6768504823336815877",
"7425631540178160939"
]
}
}
}MCP 2025-11-25 · Streamable HTTPProgress 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 |
|---|---|---|---|
videoIds | array | optional | TikTok video ID list, up to 1000. Can be obtained from video list query results Maximum items: 1000 |
videoIds[] | string | required | TikTok video ID list, up to 1000. Can be obtained from video list query results |
videoUrls | array | optional | List of TikTok video URLs (in the form of `https://www.tiktok.com/@<unique_id>/video/<videoId>` or `https://www.tiktok.com/video/<videoId>`), up to 1,000; the server extracts the last `videoId` from each URL and merges it into `videoIds`, which is not mutually exclusive with `videoIds` Maximum items: 1000 |
videoUrls[] | string | required | List of TikTok video URLs (in the form of `https://www.tiktok.com/@<unique_id>/video/<videoId>` or `https://www.tiktok.com/video/<videoId>`), up to 1,000; the server extracts the last `videoId` from each URL and merges it into `videoIds`, which is not mutually exclusive with `videoIds` |
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) |
errmsg | string | optional | Business status description |
total | integer | optional | Number of videos returned |
columns | array | optional | Render column definition (each item contains `field`/`title`/`cellType`/`filterable`/`sortable`) |
videos | array | optional | Video details list (see video object field below for details) |
costToken | integer | optional | Consume token |
type | string | optional | Rendering style (such as `tableListWorkbenches`) |
videoId | string | optional | Video ID |
videoDesc | string | optional | Video description/copywriting |
officialUrl | string | optional | TikTok official video address |
coverUrl | string | optional | Video cover URL |
duration | integer | optional | Video duration (seconds) |
width | string | optional | Video width (px) |
height | string | optional | Video height (px) |
ratio | string | optional | Video definition (such as 540p/720p) |
dataSize | string | optional | Video file size |
createDate | string | optional | Video release date (yyyy-MM-dd HH:mm:ss) |
userId | string | optional | Expert ID |
uniqueId | string | optional | TikTok account ID (unique_id) |
avatar | string | optional | Master avatar URL |
totalViewsCnt | integer | optional | Total views |
totalViews1dCnt | integer | optional | Play volume increase in the last day |
totalViews7dCnt | integer | optional | Increase in playback volume in the last 7 days |
totalViews30dCnt | integer | optional | Increase in playback volume in the last 30 days |
totalDiggCnt | integer | optional | Total likes |
totalDigg1dCnt | integer | optional | Increase in likes in the last 1 day |
totalDigg7dCnt | integer | optional | Increase in likes in the last 7 days |
totalDigg30dCnt | integer | optional | Increase in likes in the last 30 days |
totalCommentsCnt | integer | optional | Total comments |
totalSharesCnt | integer | optional | Total shares |
totalFavoritesCnt | integer | optional | Total collections |
totalVideoSaleCnt | integer | optional | Video sales (pieces, estimate) |
totalVideoSaleGmvAmt | integer | optional | Video sales GMV (estimated amount) |
salesFlagText | string | optional | Whether to bring goods video (yes/no) |
isAdText | string | optional | Whether to stream video (yes/no) |
createdByAiText | string | optional | Whether AI video (yes/no/unknown) |
productCategoryList | string | optional | Associated product classification (JSON string, empty means `[]`) |
videoProducts | string | optional | Product with video (JSON string, empty means `[]`) |
region | string | optional | The region code where the video is located |
sourceType | string | optional | Data source (such as TikTok) |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Show the details of TikTok video 7030893014180531462.
Illustrative Response Explanation
The illustrative result contains a 30-second product demonstration with 1,000 total views. These sample values do not establish sales or the performance of other videos.
About this sample: Illustrative format example with fictional duration and views, not a live video lookup.
Published sample data is not available for this page. A format illustration or workflow guide is not a substitute for a published result.
View the MCP Request & Response Format
Examples
Illustrative example with fictional data, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "data-et-batch-video-detail-example",
"method": "tools/call",
"params": {
"name": "nexscope_data_et_batch_video_detail",
"arguments": {
"videoIds": [
"7030893014180531462"
]
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "data-et-batch-video-detail-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"videos\":[{\"videoId\":\"7030893014180531462\",\"videoDesc\":\"Example product demonstration\",\"duration\":30,\"totalViewsCnt\":1000}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"videos": [
{
"videoId": "7030893014180531462",
"videoDesc": "Example product demonstration",
"duration": 30,
"totalViewsCnt": 1000
}
]
}
},
"isError": false
}
}