TikTok Intelligence ET
TikTok Product Search MCP
Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data. Call via REST API or MCP with your Nexscope API key.
TikTok Product Search 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. Find TikTok Shop Products
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Show the available results and clearly identify missing information. For this selection, choose United States, Indonesia, Thailand, Philippines, Malaysia, Vietnam, United Kingdom, Mexico, Singapore, Saudi Arabia, Brazil, Spain, Japan, Germany, Italy or France.
2. Review A Specific Reporting Period
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Use [my chosen reporting period] and show the period with the returned figures. Keep dated snapshots distinct from current data.
3. Continue The Results Within A Page Limit
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] 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.
4. Prioritize The Results For Review
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Prioritize [my chosen ranking metric] in [my chosen order]. Keep the ranking limited to the selected filters and reporting period. For this selection, choose total sales, total GMV, average SPU price, 7-day sales, 30-day sales, 7-day GMV or 30-day GMV.
5. Find Matches By Total Sales
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Limit results to [my chosen total sales range]. Keep the lower and upper bounds consistent and show only the matching records.
6. Find Matches By Total Sale30D Cnt
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Limit results to [my chosen total sale30d cnt range]. Keep the lower and upper bounds consistent and show only the matching records.
7. Find Matches By Product Total GMV
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Limit results to [my chosen product total gmv range]. Keep the lower and upper bounds consistent and show only the matching records.
8. Find Matches By Product Total GMV For This Search
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Limit results to [my chosen product total gmv range]. Keep the lower and upper bounds consistent and show only the matching records.
9. Find Matches By Spu Average Price
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Limit results to [my chosen spu average price range]. Keep the lower and upper bounds consistent and show only the matching records.
10. Find Matches By Product Rating
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Limit results to [my chosen product rating range]. Keep the lower and upper bounds consistent and show only the matching records.
11. Find Matches By Review Count
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Limit results to [my chosen review count range]. Keep the lower and upper bounds consistent and show only the matching records.
12. Find Matches By Product Commission Rate
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Limit results to [my chosen product commission rate range]. Keep the lower and upper bounds consistent and show only the matching records.
13. Find Matches By Promoting Creator Count
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Limit results to [my chosen promoting creator count range]. Keep the lower and upper bounds consistent and show only the matching records.
14. Find Matches By Promotional Video Count
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Limit results to [my chosen promotional video count range]. Keep the lower and upper bounds consistent and show only the matching records.
15. Find Matches By Promotional View Count
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Limit results to [my chosen promotional view count range]. Keep the lower and upper bounds consistent and show only the matching records.
16. Find Matches By Product Listing Time
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Limit results to [my chosen product listing time range]. Keep the lower and upper bounds consistent and show only the matching records.
17. Narrow Results By Product Category
Prompt: Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data for [search phrase] in [target marketplace]. Use [my selected product category] 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_searchhttps://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-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_product_search",
"arguments": {
"keyword": "phone case",
"pageNumber": 1,
"pageSize": 10,
"region": "US"
}
}
}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 |
|---|---|---|---|
keyword | string | optional | Product keyword (please translate to the local language). Max length 1000 Example: phone case |
region | string | optional | Region, default US. Options: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France) Example: US |
categoryKeywordCN | string | optional | Product category (please enter in Chinese). Max length 1000 Example: phone case |
minTotalSaleCnt | integer | optional | Total sales (minimum) Example: 1 |
maxTotalSaleCnt | integer | optional | Total sales (maximum) Example: 1 |
minTotalSale30dCnt | integer | optional | 30-day sales (minimum) Example: 1 |
maxTotalSale30dCnt | integer | optional | 30-day sales (maximum) Example: 1 |
minTotalSaleGmvAmt | string | optional | Product total GMV (minimum). Max length 1000 |
maxTotalSaleGmvAmt | string | optional | Product total GMV (maximum). Max length 1000 |
minTotalSaleGmv30dAmt | string | optional | Product total GMV (30-day) (minimum). Max length 1000 |
maxTotalSaleGmv30dAmt | string | optional | Product total GMV (30-day) (maximum). Max length 1000 |
minSpuAvgPrice | number | optional | SPU average price (minimum) Example: 1 |
maxSpuAvgPrice | number | optional | SPU average price (maximum) Example: 1 |
minProductRating | number | optional | Product rating (minimum) Example: 1 |
maxProductRating | number | optional | Product rating (maximum) Example: 1 |
minReviewCount | integer | optional | Review count (minimum) Example: 1 |
maxReviewCount | integer | optional | Review count (maximum) Example: 1 |
minProductCommissionRate | number | optional | Product commission rate (minimum). Input as percentage will be automatically converted to decimal, e.g., 5%->0.05 Example: 1 |
maxProductCommissionRate | number | optional | Product commission rate (maximum). Input as percentage will be automatically converted to decimal, e.g., 5%->0.05 Example: 1 |
minTotalIflCnt | integer | optional | Promoting creator count (minimum) Example: 1 |
maxTotalIflCnt | integer | optional | Promoting creator count (maximum) Example: 1 |
minTotalVideoCnt | integer | optional | Promotional video count (minimum) Example: 1 |
maxTotalVideoCnt | integer | optional | Promotional video count (maximum) Example: 1 |
minTotalViewsCnt | integer | optional | Promotional view count (minimum) Example: 1 |
maxTotalViewsCnt | integer | optional | Promotional view count (maximum) Example: 1 |
minFirstCrawlDt | integer | optional | Product listing time (minimum), format YYYYMMDD (e.g., 20200101 represents 2020-01-01) Example: 1 |
maxFirstCrawlDt | integer | optional | Product listing time (maximum), format YYYYMMDD Example: 1 |
saleDays | integer | optional | Days the product has been on sale, unit is days Example: 1 |
productSortField | integer | optional | Sort field: 1=total sales, 2=total GMV, 3=SPU average price, 4=7-day sales, 5=30-day sales, 6=7-day GMV, 7=30-day GMV. Default 1 Example: 1 |
sortType | integer | optional | Sort direction: 0=ascending, 1=descending. Default 1 Example: 1 |
pageNum | integer | optional | Page number. Default 1 Example: 1 |
pageSize | integer | optional | Items per page. Default 50 Example: 10 |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
total | integer | optional | Number of records |
products | array | optional | Product information list (see details below) |
columns | array | optional | Rendered columns |
type | string | optional | Rendering style |
costToken | integer | optional | Consume token |
productId | string | optional | Product unique identification ID |
productName | string | optional | Product name |
title | string | optional | Product name |
imageUrl | string | optional | Product image URL |
coverUrl | string | optional | Cover image URL list |
productImageUrls | array | optional | Product image URL list |
categoryName | string | optional | Product category name |
categoryIds | array | optional | Product category ID list |
region | string | optional | area code |
currency | string | optional | Currency |
price | number | optional | Product price |
minPrice | number | optional | lowest price |
maxPrice | number | optional | highest price |
spuAvgPrice | number | optional | SPU average price |
productRating | number | optional | product rating |
reviewCount | integer | optional | Number of comments |
ratings | integer | optional | Number of comments |
productCommissionRate | number | optional | Product commission ratio |
totalSaleCnt | integer | optional | total sales |
totalSale1dCnt | integer | optional | Total sales in 1 day |
totalSale7dCnt | integer | optional | Total sales within 7 days |
totalSale15dCnt | integer | optional | Total sales within 15 days |
totalSale30dCnt | integer | optional | Total sales within 30 days |
totalSale60dCnt | integer | optional | Total sales within 60 days |
totalSale90dCnt | integer | optional | Total sales in 90 days |
monthlySalesUnits | integer | optional | monthly sales |
totalSaleGmvAmt | number | optional | total sales |
totalSaleGmv1dAmt | number | optional | Total sales in 1 day |
totalSaleGmv7dAmt | number | optional | Total sales within 7 days |
totalSaleGmv15dAmt | number | optional | Total sales in 15 days |
totalSaleGmv30dAmt | number | optional | Total sales in 30 days |
totalSaleGmv60dAmt | number | optional | Total sales in 60 days |
totalSaleGmv90dAmt | number | optional | Total sales in 90 days |
firstCrawlDt | integer | optional | Release date |
availableDate | string | optional | Release time (timestamp) |
discount | string | optional | discount information |
freeShippingText | string | optional | Is it free shipping? |
offMarkText | string | optional | Is there a discount mark? |
salesFlagText | string | optional | How to bring goods |
salesTrendFlagText | string | optional | sales trend tag |
isSShopText | string | optional | Is it an S store? |
salePropsInfo | array | optional | Sales attribute information (product specifications) |
sourceType | string | optional | Product source |
asin | string | optional | Product ID |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Search TikTok Shop products across 16 markets using sales, creator-sales, pricing, and commission data. Use “phone case”. Focus on the US.
Illustrative Response Explanation
The illustrative result shows title: Example product; product name: Example product; asin: example-asin. 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. The request uses the documented MCP page-number field; the original template used a different field name.
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
{
"pageSize": 10,
"keyword": "adidas Walking & วิ่ง รองเท้า Duramo SL ผู้ชาย สีดำ ID9849",
"pageNumber": 1,
"region": "TH"
}Response
{
"code": 0,
"msg": null,
"data": {
"total": 1,
"columns": [
{
"filterable": true,
"cellType": "text",
"field": "title",
"sortable": true,
"title": "商品名称"
},
{
"filterable": true,
"cellType": "text",
"field": "imageUrl",
"sortable": true,
"title": "商品图片URL"
},
{
"filterable": true,
"cellType": "text",
"field": "productImageUrls",
"sortable": true,
"title": "商品图片URL列表"
},
{
"filterable": true,
"cellType": "number",
"field": "price",
"sortable": true,
"title": "商品价格"
},
{
"filterable": true,
"cellType": "text",
"field": "asin",
"sortable": true,
"title": "产品ID"
},
{
"filterable": true,
"cellType": "text",
"field": "availableDate",
"sortable": true,
"title": "上架时间(时间戳)"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits",
"sortable": true,
"title": "月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "ratings",
"sortable": true,
"title": "评论数"
},
{
"filterable": true,
"cellType": "text",
"field": "categoryIds",
"sortable": true,
"title": "商品品类ID列表"
},
{
"filterable": true,
"cellType": "text",
"field": "categoryName",
"sortable": true,
"title": "商品品类名称"
},
{
"filterable": true,
"cellType": "text",
"field": "coverUrl",
"sortable": true,
"title": "封面图URL列表"
},
{
"filterable": true,
"cellType": "text",
"field": "discount",
"sortable": true,
"title": "折扣信息"
},
{
"filterable": true,
"cellType": "number",
"field": "firstCrawlDt",
"sortable": true,
"title": "上架日期"
},
{
"filterable": true,
"cellType": "text",
"field": "freeShippingText",
"sortable": true,
"title": "是否包邮"
},
{
"filterable": true,
"cellType": "text",
"field": "isSShopText",
"sortable": true,
"title": "是否S店"
},
{
"filterable": true,
"cellType": "number",
"field": "maxPrice",
"sortable": true,
"title": "最高价格"
},
{
"filterable": true,
"cellType": "number",
"field": "minPrice",
"sortable": true,
"title": "最低价格"
},
{
"filterable": true,
"cellType": "text",
"field": "offMarkText",
"sortable": true,
"title": "是否有优惠标记"
},
{
"filterable": true,
"cellType": "number",
"field": "productCommissionRate",
"sortable": true,
"title": "商品佣金比例"
},
{
"filterable": true,
"cellType": "text",
"field": "productId",
"sortable": true,
"title": "商品唯一标识ID"
},
{
"filterable": true,
"cellType": "text",
"field": "productName",
"sortable": true,
"title": "商品名称"
},
{
"filterable": true,
"cellType": "number",
"field": "productRating",
"sortable": true,
"title": "商品评分"
},
{
"filterable": true,
"cellType": "text",
"field": "region",
"sortable": true,
"title": "区域代码"
},
{
"filterable": true,
"cellType": "number",
"field": "reviewCount",
"sortable": true,
"title": "评论数量"
},
{
"filterable": true,
"cellType": "text",
"field": "salePropsInfo",
"sortable": true,
"title": "销售属性信息"
},
{
"filterable": true,
"cellType": "text",
"field": "salesFlagText",
"sortable": true,
"title": "带货方式"
},
{
"filterable": true,
"cellType": "text",
"field": "salesTrendFlagText",
"sortable": true,
"title": "销售趋势标记"
},
{
"filterable": true,
"cellType": "number",
"field": "spuAvgPrice",
"sortable": true,
"title": "SPU平均价格"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSale15dCnt",
"sortable": true,
"title": "15天内总销量"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSale1dCnt",
"sortable": true,
"title": "1天内总销量"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSale30dCnt",
"sortable": true,
"title": "30天内总销量"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSale60dCnt",
"sortable": true,
"title": "60天内总销量"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSale7dCnt",
"sortable": true,
"title": "7天内总销量"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSale90dCnt",
"sortable": true,
"title": "90天内总销量"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleCnt",
"sortable": true,
"title": "总销量"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleGmv15dAmt",
"sortable": true,
"title": "15天内总销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleGmv1dAmt",
"sortable": true,
"title": "1天内总销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleGmv30dAmt",
"sortable": true,
"title": "30天内总销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleGmv60dAmt",
"sortable": true,
"title": "60天内总销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleGmv7dAmt",
"sortable": true,
"title": "7天内总销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleGmv90dAmt",
"sortable": true,
"title": "90天内总销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "totalSaleGmvAmt",
"sortable": true,
"title": "总销售额"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceType",
"sortable": true,
"title": "商品来源"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceTool",
"sortable": true,
"title": "来源工具"
},
{
"filterable": true,
"cellType": "text",
"field": "currency",
"sortable": true,
"title": "货币"
}
],
"type": "productWorkbenches",
"products": [
{
"totalSale30dCnt": 154,
"salePropsInfo": [
{
"hasImage": false,
"salePropValues": [
{
"image": "",
"propValueId": "7057391247593359105",
"propValue": "สีดำ"
}
],
"propName": "สี"
},
{
"hasImage": false,
"salePropValues": [
{
"image": "",
"propValueId": "6985259621384636165",
"propValue": "11 UK"
},
{
"image": "",
"propValueId": "7043893618272175878",
"propValue": "9.5 UK"
},
{
"image": "",
"propValueId": "6982803273111799558",
"propValue": "3.5 UK"
},
{
"image": "",
"propValueId": "6982803273111815942",
"propValue": "4 UK"
},
{
"image": "",
"propValueId": "6984705001381775110",
"propValue": "4.5 UK"
},
{
"image": "",
"propValueId": "6982803273111832326",
"propValue": "5 UK"
},
{
"image": "",
"propValueId": "6984705001381791494",
"propValue": "5.5 UK"
},
{
"image": "",
"propValueId": "6982803273111848710",
"propValue": "6 UK"
},
{
"image": "",
"propValueId": "6998363120120956677",
"propValue": "6.5 UK"
},
{
"image": "",
"propValueId": "6982803273111865094",
"propValue": "7 UK"
},
{
"image": "",
"propValueId": "6984705001381840646",
"propValue": "7.5 UK"
},
{
"image": "",
"propValueId": "6984705001381857030",
"propValue": "8 UK"
},
{
"image": "",
"propValueId": "6998363120121022213",
"propValue": "8.5 UK"
},
{
"image": "",
"propValueId": "6985014017786169093",
"propValue": "9 UK"
},
{
"image": "",
"propValueId": "6985259621384619781",
"propValue": "10 UK"
},
{
"image": "",
"propValueId": "7057770075159463685",
"propValue": "10.5 UK"
},
{
"image": "",
"propValueId": "7057770075159480069",
"propValue": "11.5 UK"
},
{
"image": "",
"propValueId": "6985259621384652549",
"propValue": "12 UK"
},
{
"image": "",
"propValueId": "7057770075159512837",
"propValue": "12.5 UK"
},
{
"image": "",
"propValueId": "7016550857982494469",
"propValue": "13 UK"
},
{
"image": "",
"propValueId": "7073847802287376134",
"propValue": "13.5 UK"
},
{
"image": "",
"propValueId": "7032418326269724422",
"propValue": "14 UK"
},
{
"image": "",
"propValueId": "7073856591602206469",
"propValue": "14.5 UK"
}
],
"propName": "ขนาด"
}
],
"totalSale1dCnt": 4,
"salesTrendFlagText": "平稳",
"discount": "-19%",
"availableDate": "2025-03-05",
"isSShopText": "否",
"productName": "adidas Walking & วิ่ง รองเท้า Duramo SL ผู้ชาย สีดำ ID9849",
"salesFlagText": "视频带货",
"totalSale90dCnt": 1438,
"offMarkText": "否",
"sourceTool": "EchoTik-TikTok商品搜索",
"reviewCount": 254,
"price": 73.82,
"freeShippingText": "否",
"totalSaleCnt": 5654,
"totalSaleGmv1dAmt": 295.28,
"productRating": 4.9,
"totalSaleGmv90dAmt": 75483.94,
"totalSaleGmv60dAmt": 75119.79,
"productId": "1731268131436989203",
"totalSaleGmv30dAmt": 8930.92,
"firstCrawlDt": 20250305,
"coverUrl": "[{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/595/1731268131436989203_0.webp\",\"index\":0},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/595/1731268131436989203_4.jpeg\",\"index\":4},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/595/1731268131436989203_7.jpeg\",\"index\":7},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/595/1731268131436989203_5.jpeg\",\"index\":5},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/595/1731268131436989203_2.jpeg\",\"index\":2},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/595/1731268131436989203_1.jpeg\",\"index\":1},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/595/1731268131436989203_6.jpeg\",\"index\":6},{ \"url\":\"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/595/1731268131436989203_3.jpeg\",\"index\":3}]",
"totalSaleGmv15dAmt": 1318.22,
"sourceType": "Tiktok",
"minPrice": 73.82,
"maxPrice": 73.82,
"region": "TH",
"spuAvgPrice": 73.82,
"totalSale60dCnt": 1432,
"title": "adidas Walking & วิ่ง รองเท้า Duramo SL ผู้ชาย สีดำ ID9849",
"categoryName": "鞋靴 -> 男鞋 -> 男士休闲运动鞋",
"totalSaleGmv7dAmt": 457.31,
"totalSaleGmvAmt": 86767.72,
"ratings": 254,
"imageUrl": "https://agent-files.linkfox.com/tiktok/20261004/1731268131436989203.jpg",
"currency": "$",
"categoryIds": [
"601352",
"900616",
"601357"
],
"totalSale7dCnt": 7,
"asin": "1731268131436989203",
"productCommissionRate": 0.03,
"totalSale15dCnt": 21,
"monthlySalesUnits": 154
}
]
}
}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-product-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_product_search",
"arguments": {
"keyword": "phone case",
"pageSize": 10,
"region": "US",
"pageNum": 1
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "tiktok-product-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"products\":[{\"title\":\"Example product\",\"productName\":\"Example product\",\"asin\":\"example-asin\",\"productId\":\"example-productId\"}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"products": [
{
"title": "Example product",
"productName": "Example product",
"asin": "example-asin",
"productId": "example-productId"
}
]
}
},
"isError": false
}
}