TikTok Intelligence KD

TikTok Livestream Analytics

Compare TikTok shopping livestreams by sales revenue, viewers, and products sold. Call via REST API or MCP from 15 credits per call.

MCP tool name

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

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. Max length 1000 Example: US
`dateRange`	`string`	optional	Time range, e.g., last7Day (last 7 days), last30Day (last 30 days). Max length 1000 Example: last30Day
`pageNumber`	`integer`	optional	Page number, value range 1-5 (out of range returns errcode 501) 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. Max length 1000 Example: {}
`currency`	`string`	optional	Currency unit, e.g., USD. Max length 1000 Example: {}
`sortField`	`object`	optional	Sort criteria, structure defined by the gateway; pass an empty object {} for default rank order when not sorting 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: {}
`followers_range`	`string`	optional	Creator follower range filter Example: {}
`livestreamId`	`string`	optional	Target livestream unique ID (camelCase), e.g., 7661409374878878494. Typically obtained from the livestream_id in the livestream rank endpoint. Max length 1000 Example: {}

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	Live broadcast list or live broadcast details Example: {}
`costToken`	`integer`	optional	The deduction token for this call is fixed to `14000` Example: {}
`errmsg`	`string`	optional	Status message, `ok` on success Example: {}
`livestream_start_time`	`integer`	optional	Live broadcast start time (epoch milliseconds) Example: {}
`livestream_end_time`	`integer`	optional	Live broadcast end time (epoch milliseconds) Example: {}
`livestream_duration`	`integer`	optional	Live broadcast duration (seconds) Example: {}
`livestream_title`	`string`	optional	Live title Example: {}
`livestream_id`	`string`	optional	The unique ID of the live broadcast (a string to avoid the loss of large integer precision), which can be used as the `livestreamId` of the details interface Example: {}
`creator_id`	`string`	optional	The unique ID of the expert (string, to avoid loss of large integer precision) Example: {}
`creator_handle`	`string`	optional	Expert account handle Example: {}
`revenue`	`string`	optional	Total sales/GMV, returned by requested `currency`; returned as a string, such as `"185590.52"` Example: {}
`unit_price`	`string`	optional	The unit price of the piece is returned according to the requested `currency`; the return is a string, such as `"265.89"` Example: {}
`views`	`integer`	optional	Number of views Example: {}
`record_type`	`string`	optional	Record type, such as `SHORT` Example: {}
`livestream_id`	`string`	optional	Live broadcast unique ID, consistent with the requested `livestreamId` Example: {}
`livestream_title`	`string`	optional	Live title, such as `24 HOUR STREAM` Example: {}
`creator_id`	`string`	optional	The unique ID of the expert (string, to avoid loss of large integer precision) Example: {}
`creator_handle`	`string`	optional	Expert username/handle, such as `pokepiglt` Example: {}
`livestream_start_time`	`integer`	optional	Live broadcast start time, epoch milliseconds Example: {}
`livestream_end_time`	`integer`	optional	Live broadcast end time, epoch milliseconds Example: {}
`livestream_duration`	`integer`	optional	Live broadcast duration, unit seconds Example: {}
`record_type`	`string`	optional	Record type, such as `SHORT` Example: {}
`viewers`	`integer`	optional	Number of viewers; use `viewers` for details and `views` for lists Example: {}
`revenue`	`number`	optional	Live sales/GMV, returned by requested `currency`; details are of type numeric Example: {}
`gpm`	`number`	optional	GMV per mille, GMV per thousand impressions; details exclusive Example: {}
`product_number`	`integer`	optional	Number of goods delivered live Example: {}

Examples

Example arguments

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

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}