TikTok Commerce Intelligence CJ
TikTok Live Detail MCP
Look up details of a TikTok livestream. Results come back as structured JSON. Call the TikTok Live Detail API via REST or MCP with your Nexscope API key.
TikTok Live Detail 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. Look Up Details Of A TikTok Livestream
Prompt: Look up details of a TikTok livestream for [record ID] in [target marketplace]. Show the available results and clearly identify missing information.
2. Review Livestream Follower Conversion
Prompt: Look up TikTok livestream [record ID] in [supported country] with core details. Show new followers and the returned follower-conversion fraction, alongside its category. Explain any percentage conversion and do not infer sales conversion.
3. Compare Livestream Audience Conversion
Prompt: Retrieve livestreams [live ID A] and [live ID B] in [supported country] with core details in two separate requests. Compare returned new-follower counts and follower-conversion fractions, keeping categories and market context visible. Compare rates only when definitions match, and do not infer sales, revenue or causation.
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.
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_chuhaijiang_tiktok_live_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": "chuhaijiang-tiktok-live-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_live_detail",
"arguments": {
"country": "us",
"id": "7643101948819835678",
"include": "core"
}
}
}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 |
|---|---|---|---|
country | string | required | Lowercase request market. Returned country_code may differ; preserve both. Example: us |
id | string | required | Livestream ID returned by its search operation. Keep identifiers as strings to avoid precision loss. Example: 7643101948819835678 |
include | string | optional | Comma-separated expansions: core. Request only needed expansions. Example: core |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
errcode | integer | optional | 200 means success |
errmsg | string | optional | `ok` on success |
request_id | string | optional | Request tracking ID |
data | object | optional | The basic information is in `data.items[]`; when it is `include=core`, there is also `data.core.items[]` |
id | string | optional | Live broadcast room ID |
country_code | string | optional | Record country code |
most_product_category_label | string | optional | Main product categories |
core_new_follow_count | number | optional | Number of new fans |
core_follower_conversion_rate | number | optional | Fan conversion rate decimal value |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Look up details of a TikTok livestream. Use record ID 7643101948819835678. Focus on the US.
Illustrative Response Explanation
The illustrative result shows id: 7643101948819835678. These figures describe only the shown record. Missing measures cannot be calculated from this example.
About this sample: Illustrative example with fictional records, not a live tool call. Identifiers, prices and counts are demonstration values.
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": "chuhaijiang-tiktok-live-detail-example",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_live_detail",
"arguments": {
"country": "us",
"id": "7643101948819835678",
"include": "core"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "chuhaijiang-tiktok-live-detail-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":{\"items\":[{\"id\":\"7643101948819835678\"}]}}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": {
"items": [
{
"id": "7643101948819835678"
}
]
}
}
},
"isError": false
}
}