TikTok Intelligence KD

TikTok Video Analytics

Compare TikTok promotional videos by views, engagement, and sales revenue. Call the TikTok Video Analytics API via REST or MCP from 15 credits per call.

MCP tool name

nexscope_tiktok_video_analytics

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-analytics-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_video_analytics",
    "arguments": {
      "dateRange": "last30Day",
      "pageNumber": 1,
      "pageSize": 10,
      "region": "US",
      "sortField": {},
      "videoId": "6768504823336815877"
    }
  }
}

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`	optional	Region/market code, e.g., US Example: US
`dateRange`	`string`	optional	Time range, e.g., last7Day, last30Day Example: last30Day
`pageNumber`	`integer`	optional	Page number, value range 1-5 Example: 1
`pageSize`	`integer`	optional	Items per page, value range 5-100 Example: 10
`language`	`string`	optional	Return language, e.g., zh-CN, en-US Example: {}
`currency`	`string`	optional	Currency unit, e.g., USD Example: {}
`sortField`	`object`	optional	Sort criteria; omitted to use default rank order Example: {}
`category_id`	`string`	optional	Category ID filter Example: {}
`shop_id`	`string`	optional	Shop ID filter Example: {}
`creator_id`	`string`	optional	Creator ID filter Example: {}
`product_id`	`string`	optional	Product ID filter Example: {}
`revenue_range`	`string`	optional	GMV range; response field revenue is total GMV Example: {}
`followers_range`	`string`	optional	Creator follower range filter Example: {}
`ads_roas`	`number`	optional	Advertising ROAS filter Example: {}
`videoId`	`string`	optional	TikTok video ID, e.g., 7659161409279806734, obtainable from the video_id in the video rank response Example: 6768504823336815877

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`errcode`	`integer`	optional	Business status code, `200` indicates success Example: {}
`data`	`array`	optional	Video details data, usually a 1-element array when successful Example: {}
`costToken`	`integer`	optional	The deduction token for this call is usually `14000` Example: {}
`errmsg`	`string`	optional	Status message, `ok` on success Example: {}
`video_id`	`string`	optional	Video ID, string format to avoid loss of precision for large integers Example: {}
`video_title`	`string`	optional	Video title/copywriting Example: {}
`video_region`	`string`	optional	Video region, may be an empty string Example: {}
`belonged_creator_id`	`string`	optional	Attribution expert ID Example: {}
`belonged_creator_handle`	`string`	optional	Attribution expert username Example: {}
`views`	`integer`	optional	Play volume Example: {}
`digg_count`	`integer`	optional	Number of likes Example: {}
`comment_count`	`integer`	optional	Number of comments Example: {}
`share_count`	`integer`	optional	Number of shares Example: {}
`revenue`	`number`	optional	Total Sales/GMV Example: {}
`sales_volumn`	`integer`	optional	Sales volume, field spelled `volumn` Example: {}
`video_gpm`	`number`	optional	Video GPM, or GMV per thousand plays Example: {}
`ad`	`integer`	optional	Whether to run ads, 1=with ads, 0=without ads Example: {}
`ads_views`	`integer`	optional	Number of ad plays Example: {}
`ads_roas`	`number`	optional	Advertising ROAS Example: {}
`ad_cpa`	`number`	optional	Advertising CPA Example: {}
`ad_view_ratio`	`number`	optional	Advertisement playback proportion (%) Example: {}
`ads_period`	`integer`	optional	Advertising period (days) Example: {}
`duration`	`number`	optional	Video duration (seconds) Example: {}
`product_number`	`integer`	optional	Number of video related products Example: {}

Examples

Example arguments

{
  "dateRange": "last30Day",
  "pageNumber": 1,
  "pageSize": 10,
  "region": "US",
  "sortField": {},
  "videoId": "6768504823336815877"
}

Example structuredContent

{}