TikTok Intelligence KD
TikTok Product Analytics MCP
Analyze TikTok Shop product leaderboards and product-level price, sales, revenue, commission, listing status, and shop data. Call it via REST API or MCP.
TikTok Product 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. Review TikTok Shop Product Performance
Prompt: Review TikTok Shop product performance for [product ID] in [target marketplace]. Show the available results and clearly identify missing information.
2. Research In A Selected Currency
Prompt: Review TikTok Shop product performance for [product 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.
3. Research In A Selected Language
Prompt: Review TikTok Shop product performance for [product ID] in [target marketplace]. Return the available descriptions in [my preferred supported language], while keeping identifiers unchanged.
4. Review A Specific Reporting Period
Prompt: Review TikTok Shop product performance for [product 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: Review TikTok Shop product performance for [product 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: Review TikTok Shop product performance for [product 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 Revenue / GMV
Prompt: Review TikTok Shop product performance for [product ID] in [target marketplace]. Limit results to [my chosen revenue / gmv range]. Keep the lower and upper bounds consistent and show only the matching records.
8. Find Matches By Product Unit-Price
Prompt: Review TikTok Shop product performance for [product ID] in [target marketplace]. Limit results to [my chosen product unit-price range]. Keep the lower and upper bounds consistent and show only the matching records.
9. Narrow Results By Category ID List
Prompt: Review TikTok Shop product performance for [product ID] in [target marketplace]. Use [my selected category id list] to narrow the results. Report only what the selected records support.
10. Narrow Results By Shop ID
Prompt: Review TikTok Shop product performance for [product ID] in [target marketplace]. Use [my selected shop id] to narrow the results. Report only what the selected records support.
11. Narrow Results By Creator ID
Prompt: Review TikTok Shop product performance for [product ID] in [target marketplace]. Use [my selected creator id] to narrow the results. Report only what the selected records support.
12. Narrow Results By Return Products Associated With The Specified Video
Prompt: Review TikTok Shop product performance for [product ID] in [target marketplace]. Use [my selected return products associated with the specified video] to narrow the results. Report only what the selected records support.
13. Review Products From A Livestream
Prompt: Review performance for [product ID] in [target marketplace], limited to products associated with [livestream ID]. Summarize the available product metrics for that selection.
14. Find Affiliate Products
Prompt: Review TikTok Shop product performance for [product ID] in [target marketplace]. Use [my affiliate-product preference] to narrow the results. Report only what the selected records support.
15. Narrow Results By Affiliate Commission Rate, E.G
Prompt: Review TikTok Shop product performance for [product ID] in [target marketplace]. Use [my selected affiliate commission rate, e.g] to narrow the results. Report only what the selected records support.
16. Find TikTok Shop Products
Prompt: Review TikTok Shop product performance for [product ID] in [target marketplace]. Use [my TikTok Shop product preference] 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_product_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-product-analytics-1",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_product_analytics",
"arguments": {
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 10,
"productId": "1732505564636812173",
"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 | TikTok Shop market region code, e.g., US. If not specified, defaults to the server default (usually US) Example: US |
dateRange | string | optional | Relative date range, e.g., last7Day, last30Day Example: last30Day |
currency | string | optional | Currency code, e.g., USD |
language | string | optional | Return language, e.g., zh-CN, en-US |
sortField | object | optional | Sort specification object; omitted to use default ranking Example: {} |
category_ids | array | optional | Category ID list filter Example: [] |
shop_id | string | optional | Shop ID filter |
creator_id | string | optional | Creator ID filter |
video_id | string | optional | Return products associated with the specified video |
livestream_id | string | optional | Return products associated with the specified livestream |
revenue_range | string | optional | Revenue / GMV range filter |
is_affiliate | string | optional | Affiliate filter: PUBLIC_PLAN or NON_AFFILIATE |
commission_rate | number | optional | Affiliate commission rate, e.g. 0.15 |
is_tts_product | integer | optional | Fully managed product filter: 1 or 0 |
unit_price_range | string | optional | Product unit-price range filter |
pageNumber | integer | optional | Page number, range 1-5 Example: 1 |
pageSize | integer | optional | Items per page, range 5-100 Example: 10 |
productId | string | optional | TikTok product ID, e.g., 1729508370969629931 (string format, to avoid large integer precision loss), obtainable from the product_id in the product rank response Example: 1732505564636812173 |
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 | List or detailed data; real response does not return `total` |
costToken | integer | optional | The deduction token for this call is usually `14000` |
errmsg | string | optional | Status message, `ok` on success |
product_id | string | optional | Product ID (string format to avoid loss of large integer precision), can be used as `productId` to query details |
product_name | string | optional | Product title |
unit_price | number | optional | Unit price, currency depends on `region`, such as US is USD |
sales_volumn | integer | optional | Sales volume (units); field name `sales_volumn`, not `volume` |
revenue | number | optional | Total sales / GMV, equals `video_revenue` + `live_revenue` + `showcase_revenue` |
video_revenue | number | optional | Video channel sales |
live_revenue | number | optional | Live broadcast channel sales |
showcase_revenue | number | optional | Window/display channel sales |
revenue_growth_rate | number | optional | Sales growth rate (percentage, e.g. `27.94` represents 27.94%) |
commission_rate | number | optional | Commission rate, direct percentage, such as `25.0` means 25%, not basis points |
launch_date | string | optional | Date on shelves (`YYYY-MM-DD`) |
product_id | string | optional | Unique product ID (string, to avoid loss of large integer precision) |
product_name | string | optional | Product name |
product_region | string | optional | The region/market where the product is located, such as `us` |
product_shop_id | string | optional | Store ID |
pri_cate_id | string | optional | First level category ID |
sec_cate_id | string | optional | Secondary category ID |
ter_cate_id | string | optional | Third-level category ID |
unit_price | number | optional | Unit price in requested `currency` currency |
min_price | number | optional | Lowest price in requested `currency` currency |
max_price | number | optional | Highest price in requested `currency` currency |
revenue | number | optional | Total sales/GMV by requested `currency` currency |
sales_volumn | integer | optional | Sales volume, field spelled `volumn` |
commission_rate | number | optional | Commission rate, direct percentage, `25.0` means 25% |
product_review_count | integer | optional | Number of product reviews |
launch_date | string | optional | Date on shelves (`YYYY-MM-DD`) |
delivery_type | string | optional | Shipping method, such as `local` |
video_number | integer | optional | Number of associated videos |
video_revenue | number | optional | Sales generated by video in requested `currency` currency |
live_number | integer | optional | Number of associated live broadcasts |
live_revenue | number | optional | Sales generated by live streaming, in requested `currency` currency |
shopping_mall_revenue | number | optional | Marketplace sales in requested `currency` currency |
creator_number | integer | optional | Number of connected people |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Review TikTok Shop product performance. Use product ID 1734020651102734110. Focus on Thailand.
Example Answer
In the published sample, its reported product name is AKCKแผ่นแปะสมุนไพรหอมระเหยจากพืช ช่วยผ่อนคลายจิตใจ สร้างบรรยากาศสบายก่อนนอน และบรรเทาความเจ็บปวดในยามค่ำคืน. Its reported revenue is 2212535.2. Its reported sales volumn is 30211. These observations apply only to the shown record and reporting scope.
About this sample: Published documentation excerpt, not a live query. Arrays show at most two records and long text may be shortened. Missing units, dates or coverage remain unspecified; the excerpt does not represent the complete dataset.
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
{
"productId": "1734020651102734110",
"region": "TH",
"currency": "THB",
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 5
}Response
{
"code": 0,
"msg": null,
"data": {
"data": [
{
"sec_cate_id": "950792",
"product_region": "th",
"creator_number": 611,
"video_revenue": 2203814.26,
"sales_volumn": 30211,
"video_number": 1970,
"ter_cate_id": "951176",
"unit_price": 73.24,
"product_name": "AKCKแผ่นแปะสมุนไพรหอมระเหยจากพืช ช่วยผ่อนคลายจิตใจ สร้างบรรยากาศสบายก่อนนอน และบรรเทาความเจ็บปวดในยามค่ำคืน",
"revenue": 2212535.2,
"max_price": 201.73,
"min_price": 84.47,
"delivery_type": "local",
"product_review_count": 9060,
"product_id": "1734020651102734110",
"pri_cate_id": "700645",
"live_number": 222,
"commission_rate": 11,
"launch_date": "2026-01-16",
"shopping_mall_revenue": 71.15,
"product_description": [
{
"sub": [
{
"b": true,
"t": "ฝ่ายบริการลูกค้า: หากคุณได้รับสินค้าที่เสียหาย จำนวนไม่ครบ หรือสินค้ามีตำหนิ โปรดติดต่อฝ่ายบริการลูกค้าของเราผ่านทางข้อความส่วนตัวใน TikTok ก่อนที่จะเขียนรีวิว และส่งรูปภาพของปัญหามาด้วย เราจะแก้ไขปัญหาให้คุณทันที!"
}
],
"text": "ฝ่ายบริการลูกค้า: หากคุณได้รับสินค้าที่เสียหาย จำนวนไม่ครบ หรือสินค้ามีตำหนิ โปรดติดต่อฝ่ายบริการลูกค้าของเราผ่านทางข้อความส่วนตัวใน TikTok ก่อนที่จะเขียนรีวิว และส่งรูปภาพของปัญหามาด้วย เราจะแก้ไขปัญหาให้คุณทันที!",
"type": "text"
},
{
"sub": [
{
"t": "วิธีใช้:"
}
],
"text": "วิธีใช้:",
"type": "text"
},
{
"sub": [
{
"t": "1. ลอกแผ่นฟิล์มออก"
}
],
"text": "1. ลอกแผ่นฟิล์มออก",
"type": "text"
},
{
"sub": [
{
"t": "2. ทาผลิตภัณฑ์ลงบนร่างกายของคุณ"
}
],
"text": "2. ทาผลิตภัณฑ์ลงบนร่างกายของคุณ",
"type": "text"
},
{
"sub": [
{
"t": "3. ลอกออกหลังจากตื่นนอน (ประมาณ 8-12 ชั่วโมง)"
}
],
"text": "3. ลอกออกหลังจากตื่นนอน (ประมาณ 8-12 ชั่วโมง)",
"type": "text"
},
{
"sub": [
{
"t": "4. แนะนำว่าไม่ควรใช้เกิน 48 ชั่วโมง มิเช่นนั้นผิวหนังอาจรับไม่ไหว (แตกต่างกันไปในแต่ละบุคคล)"
}
],
"text": "4. แนะนำว่าไม่ควรใช้เกิน 48 ชั่วโมง มิเช่นนั้นผิวหนังอาจรับไม่ไหว (แตกต่างกันไปในแต่ละบุคคล)",
"type": "text"
},
{
"sub": [
{
"t": "ชื่อผลิตภัณฑ์: แผ่นแปะช่วยนอนหลับ สรรพคุณ: ช่วยในการนอนหลับ จำนวน: 12 ชิ้น วัสดุ: ผ้าไม่ทอ อายุการใช้งาน: 3 ปี การเก็บรักษา: เก็บในที่แห้งและเย็น"
}
],
"text": "ชื่อผลิตภัณฑ์: แผ่นแปะช่วยนอนหลับ สรรพคุณ: ช่วยในการนอนหลับ จำนวน: 12 ชิ้น วัสดุ: ผ้าไม่ทอ อายุการใช้งาน: 3 ปี การเก็บรักษา: เก็บในที่แห้งและเย็น",
"type": "text"
},
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/d908990783624c5d9e106c582fb31d00~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086",
"https://p19-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/d908990783624c5d9e106c582fb31d00~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086"
],
"width": 1728,
"uri": "tos-alisg-i-aphluv4xwc-sg/d908990783624c5d9e106c582fb31d00",
"height": 2304
},
"type": "image"
},
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/a18f59aa845e4874983411919a78a34a~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086",
"https://p19-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/a18f59aa845e4874983411919a78a34a~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086"
],
"width": 1728,
"uri": "tos-alisg-i-aphluv4xwc-sg/a18f59aa845e4874983411919a78a34a",
"height": 2304
},
"type": "image"
},
{
"image": {
"remove_gap": "false",
"url_list": [
"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/b07a49c754f846acb3e6d465e77ab4f9~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086",
"https://p19-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/b07a49c754f846acb3e6d465e77ab4f9~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086"
],
"width": 1728,
"uri": "tos-alisg-i-aphluv4xwc-sg/b07a49c754f846acb3e6d465e77ab4f9",
"height": 2304
},
"type": "image"
}
],
"product_shop_id": "7494255174154028830",
"live_revenue": 8649.8
}
]
}
}View the MCP Request & Response Format
Examples
Based on a published documentation sample, 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-product-analytics-example",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_product_analytics",
"arguments": {
"productId": "1734020651102734110",
"region": "TH",
"currency": "THB",
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 5
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "tiktok-product-analytics-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"product_name\":\"AKCKแผ่นแปะสมุนไพรหอมระเหยจากพืช ช่วยผ่อนคลายจิตใจ สร้างบรรยากาศสบายก่อนนอน และบรรเทาความเจ็บปวดในยามค่ำคืน\",\"revenue\":2212535.2,\"sales_volumn\":30211,\"sec_cate_id\":\"950792\",\"product_region\":\"th\",\"creator_number\":611,\"video_revenue\":2203814.26,\"video_number\":1970,\"ter_cate_id\":\"951176\",\"unit_price\":73.24,\"max_price\":201.73,\"min_price\":84.47}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"product_name": "AKCKแผ่นแปะสมุนไพรหอมระเหยจากพืช ช่วยผ่อนคลายจิตใจ สร้างบรรยากาศสบายก่อนนอน และบรรเทาความเจ็บปวดในยามค่ำคืน",
"revenue": 2212535.2,
"sales_volumn": 30211,
"sec_cate_id": "950792",
"product_region": "th",
"creator_number": 611,
"video_revenue": 2203814.26,
"video_number": 1970,
"ter_cate_id": "951176",
"unit_price": 73.24,
"max_price": 201.73,
"min_price": 84.47
}
]
}
},
"isError": false
}
}