TikTok Intelligence KD
TikTok Livestream Analytics MCP
Compare TikTok shopping livestreams by sales revenue, viewers, and products sold. Call via REST API or MCP with your Nexscope API key.
TikTok Livestream Analytics 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 TikTok Shopping Livestreams
Prompt: Compare TikTok Shopping Livestreams for [livestream ID] in [target marketplace]. Show the available results and clearly identify missing information.
2. Research In A Selected Language
Prompt: Compare TikTok Shopping Livestreams for [livestream ID] in [target marketplace]. Return the available descriptions in [my preferred supported language], while keeping identifiers unchanged.
3. Research In A Selected Currency
Prompt: Compare TikTok Shopping Livestreams for [livestream ID] in [target marketplace]. Present the available monetary values in [my selected currency], using [my supplied conversion rate] only if the tool requires one. Do not compare amounts in different currencies.
4. Review A Specific Reporting Period
Prompt: Compare TikTok Shopping Livestreams for [livestream ID] in [target marketplace]. Use [my chosen reporting period] and show the period with the returned figures. Keep dated snapshots distinct from current data.
5. Continue The Results Within A Page Limit
Prompt: Compare TikTok Shopping Livestreams for [livestream ID] in [target marketplace]. Start at [my selected page] and return [my requested page size] within the documented limits. Ask before requesting another page and do not describe one page as the complete dataset.
6. Prioritize The Results For Review
Prompt: Compare TikTok Shopping Livestreams for [livestream ID] in [target marketplace]. Prioritize [my chosen ranking metric] in [my chosen order]. Keep the ranking limited to the selected filters and reporting period.
7. Find Matches By Creator Follower
Prompt: Compare TikTok Shopping Livestreams for [livestream ID] in [target marketplace]. Limit results to [my chosen creator follower range]. Keep the lower and upper bounds consistent and show only the matching records.
8. Narrow Results By Category ID
Prompt: Compare TikTok Shopping Livestreams for [livestream ID] in [target marketplace]. Use [my selected category id] to narrow the results. Report only what the selected records support.
9. Narrow Results By Shop ID
Prompt: Compare TikTok Shopping Livestreams for [livestream ID] in [target marketplace]. Use [my selected shop id] to narrow the results. Report only what the selected records support.
10. Narrow Results By Creator ID
Prompt: Compare TikTok Shopping Livestreams for [livestream ID] in [target marketplace]. Use [my selected creator id] to narrow the results. Report only what the selected records support.
11. Narrow Results By Product ID
Prompt: Compare TikTok Shopping Livestreams for [livestream ID] in [target marketplace]. Use [my selected product id] to narrow the results. Report only what the selected records support.
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_tiktok_livestream_analyticshttps://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": "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 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 |
|---|---|---|---|
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 |
currency | string | optional | Currency unit, e.g., USD. Max length 1000 |
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 |
shop_id | string | optional | Shop ID filter |
creator_id | string | optional | Creator ID filter |
product_id | string | optional | Product ID filter |
followers_range | string | optional | Creator follower range filter |
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 |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
errcode | integer | optional | Business status code, `200` indicates success |
data | array | optional | Live broadcast list or live broadcast details |
costToken | integer | optional | The deduction token for this call is fixed to `14000` |
errmsg | string | optional | Status message, `ok` on success |
livestream_start_time | integer | optional | Live broadcast start time (epoch milliseconds) |
livestream_end_time | integer | optional | Live broadcast end time (epoch milliseconds) |
livestream_duration | integer | optional | Live broadcast duration (seconds) |
livestream_title | string | optional | Live title |
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 |
creator_id | string | optional | The unique ID of the expert (string, to avoid loss of large integer precision) |
creator_handle | string | optional | Expert account handle |
revenue | string | optional | Total sales/GMV, returned by requested `currency`; returned as a string, such as `"185590.52"` |
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"` |
views | integer | optional | Number of views |
record_type | string | optional | Record type, such as `SHORT` |
livestream_id | string | optional | Live broadcast unique ID, consistent with the requested `livestreamId` |
livestream_title | string | optional | Live title, such as `24 HOUR STREAM` |
creator_id | string | optional | The unique ID of the expert (string, to avoid loss of large integer precision) |
creator_handle | string | optional | Expert username/handle, such as `pokepiglt` |
livestream_start_time | integer | optional | Live broadcast start time, epoch milliseconds |
livestream_end_time | integer | optional | Live broadcast end time, epoch milliseconds |
livestream_duration | integer | optional | Live broadcast duration, unit seconds |
record_type | string | optional | Record type, such as `SHORT` |
viewers | integer | optional | Number of viewers; use `viewers` for details and `views` for lists |
revenue | number | optional | Live sales/GMV, returned by requested `currency`; details are of type numeric |
gpm | number | optional | GMV per mille, GMV per thousand impressions; details exclusive |
product_number | integer | optional | Number of goods delivered live |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Compare TikTok shopping livestreams by sales revenue, viewers, and products sold. Focus on the US.
Illustrative Response Explanation
The illustrative result shows revenue: 19.99. 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.
View the Published Sample Data (JSON)
Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.
Data Example
Sample request and response
Request parameters
{
"region": "US",
"page": 1,
"size": 5
}Response
{
"code": 0,
"msg": null,
"data": {
"data": [
{
"livestream_start_time": "1790105782000",
"livestream_duration": 29998,
"revenue": "327961.84",
"livestream_title": "",
"creator_id": "6677756329987228678",
"livestream_id": "7688445351061195533",
"creator_handle": "byenblanfaktori",
"unit_price": "7.73",
"livestream_end_time": "1790135780000",
"views": 408515,
"record_type": "SHORT"
},
{
"livestream_start_time": "1789468902000",
"livestream_duration": 522419,
"revenue": "124951.0",
"livestream_title": "DEALS FOR YOU - Live Now!",
"creator_id": "7153432386608251946",
"livestream_id": "7685709140785728287",
"creator_handle": "based",
"unit_price": "27.83",
"livestream_end_time": "1789991321000",
"views": 3813644,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790143565000",
"livestream_duration": 4489,
"revenue": "122173.0",
"livestream_title": "DEALS FOR YOU - Live Now!",
"creator_id": "7153432386608251946",
"livestream_id": "7688607461032348446",
"creator_handle": "based",
"unit_price": "28.38",
"livestream_end_time": "1790148054000",
"views": 35956,
"record_type": "SHORT"
},
{
"livestream_start_time": "1789948635000",
"livestream_duration": 21369,
"revenue": "105431.93",
"livestream_title": "Ripping The Hottest Sports Cards",
"creator_id": "6688398622600692742",
"livestream_id": "7687770584767318815",
"creator_handle": "burtonbreaks",
"unit_price": "184.0",
"livestream_end_time": "1789970004000",
"views": 359696,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790338081000",
"livestream_duration": 127381,
"revenue": "104258.0",
"livestream_title": "DEALS FOR YOU - Live Now!",
"creator_id": "7153432386608251946",
"livestream_id": "7689442635441834782",
"creator_handle": "based",
"unit_price": "28.38",
"livestream_end_time": "1790465462000",
"views": 1064234,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790355613000",
"livestream_duration": 43808,
"revenue": "104146.5",
"livestream_title": "MINT MONEY STAR ROBE DROP 💚💸",
"creator_id": "6787875411281134598",
"livestream_id": "7689518323038128910",
"creator_handle": "jeffreestar",
"unit_price": "28.59",
"livestream_end_time": "1790399421000",
"views": 497834,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790383058000",
"livestream_duration": 20813,
"revenue": "98712.94",
"livestream_title": "Hola❤️",
"creator_id": "6800598044448457733",
"livestream_id": "7689636419756706591",
"creator_handle": ".brendaayala1",
"unit_price": "29.7",
"livestream_end_time": "1790403871000",
"views": 315245,
"record_type": "SHORT"
},
{
"livestream_start_time": "1789992320000",
"livestream_duration": 4512,
"revenue": "94207.0",
"livestream_title": "DEALS FOR YOU - Live Now!",
"creator_id": "7153432386608251946",
"livestream_id": "7687957811115969310",
"creator_handle": "based",
"unit_price": "29.9",
"livestream_end_time": "1789996832000",
"views": 32863,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790092508000",
"livestream_duration": 14896,
"revenue": "87770.93",
"livestream_title": "💝Medicube x Nello Collab Mega💝",
"creator_id": "7291517492299007018",
"livestream_id": "7688388230848219917",
"creator_handle": "medicube_official_shop",
"unit_price": "34.31",
"livestream_end_time": "1790107404000",
"views": 61503,
"record_type": "FULL"
},
{
"livestream_start_time": "1790017706000",
"livestream_duration": 12414,
"revenue": "79376.5",
"livestream_title": "",
"creator_id": "7014603102829593606",
"livestream_id": "7688067090044963598",
"creator_handle": "simplymandys",
"unit_price": "37.65",
"livestream_end_time": "1790030120000",
"views": 80987,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790355686000",
"livestream_duration": 10779,
"revenue": "73958.43",
"livestream_title": "NOELY FAJAS MEGA LIVE",
"creator_id": "6801519791112897542",
"livestream_id": "7689518679498787614",
"creator_handle": "noelyfajas",
"unit_price": "89.65",
"livestream_end_time": "1790366465000",
"views": 75247,
"record_type": "FULL"
},
{
"livestream_start_time": "1790270453000",
"livestream_duration": 51829,
"revenue": "72404.21",
"livestream_title": "",
"creator_id": "6829169369835127814",
"livestream_id": "7689152573131066125",
"creator_handle": "calicurvesfajas",
"unit_price": "65.7",
"livestream_end_time": "1790322282000",
"views": 222287,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790355124000",
"livestream_duration": 36821,
"revenue": "70073.0",
"livestream_title": "Fajas colombianas 🇨🇴",
"creator_id": "7179385436960310318",
"livestream_id": "7689516256734530317",
"creator_handle": "alondrixsexycurves",
"unit_price": "118.17",
"livestream_end_time": "1790391945000",
"views": 165052,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790295054000",
"livestream_duration": 23887,
"revenue": "68666.76",
"livestream_title": "Hola!!❤️",
"creator_id": "6800598044448457733",
"livestream_id": "7689258465444760351",
"creator_handle": ".brendaayala1",
"unit_price": "26.07",
"livestream_end_time": "1790318941000",
"views": 281085,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790108377000",
"livestream_duration": 3533,
"revenue": "64389.0",
"livestream_title": "DEALS FOR YOU - Live Now!",
"creator_id": "7153432386608251946",
"livestream_id": "7688456553828993823",
"creator_handle": "based",
"unit_price": "28.59",
"livestream_end_time": "1790111910000",
"views": 40296,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790249163000",
"livestream_duration": 127738,
"revenue": "63659.89",
"livestream_title": "RIPS ALL DAYYY!!!",
"creator_id": "6906678272890848261",
"livestream_id": "7689060444446722847",
"creator_handle": "allpoketcg",
"unit_price": "142.42",
"livestream_end_time": "1790376901000",
"views": 167774,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790116436000",
"livestream_duration": 2818,
"revenue": "62098.65",
"livestream_title": "FAST PACED TECH Nick",
"creator_id": "7617890876685108238",
"livestream_id": "7688491201942522655",
"creator_handle": "refreshed.tech",
"unit_price": "459.99",
"livestream_end_time": "1790119254000",
"views": 13763,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790285688000",
"livestream_duration": 31709,
"revenue": "54655.29",
"livestream_title": "",
"creator_id": "7043091206013060102",
"livestream_id": "7689218099326225165",
"creator_handle": "glamourmodernfashion1",
"unit_price": "73.07",
"livestream_end_time": "1790317397000",
"views": 66047,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790268132000",
"livestream_duration": 12027,
"revenue": "50930.0",
"livestream_title": "",
"creator_id": "7042472144287466543",
"livestream_id": "7689142531280046879",
"creator_handle": "djounefelix5",
"unit_price": "339.53",
"livestream_end_time": "1790280159000",
"views": 51296,
"record_type": "SHORT"
},
{
"livestream_start_time": "1790035193000",
"livestream_duration": 2237,
"revenue": "48597.51",
"livestream_title": "Ripping The Hottest Sports Cards",
"creator_id": "6688398622600692742",
"livestream_id": "7688142341407853343",
"creator_handle": "burtonbreaks",
"unit_price": "109.95",
"livestream_end_time": "1790037430000",
"views": 5878,
"record_type": "SHORT"
}
]
}
}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": "tiktok-livestream-analytics-example",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_livestream_analytics",
"arguments": {
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 10,
"region": "US",
"sortField": {}
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "tiktok-livestream-analytics-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"revenue\":19.99}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"revenue": 19.99
}
]
}
},
"isError": false
}
}