TikTok Shop
Search and analyze TikTok product data including sales, influencer sales data, pricing, and commission rates across 16 TikTok Shop sites.
nexscope_tiktok_product_searchhttps://api.nexscope.ai/api/skill-api/v2/mcptools/callUse OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope for standard remote clients. API keys remain supported as a compatibility option while v1 integrations migrate.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.
Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/api/skill-api/v2/mcp, then use tools/call with the MCP tool name below. The arguments object should match the table on this page.
{
"jsonrpc": "2.0",
"id": "tiktok-product-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_product_search",
"arguments": {
"pageSize": 10,
"keyword": "phone case",
"pageNumber": 1,
"region": "US"
}
}
}MCP 2025-11-25 · Streamable HTTPhttps://www.nexscope.ai/mcp-map/tiktok-product-searchProgress is delivered on the original POST SSE response when the client supplies a progress token and the tool has real execution stages. GET SSE carries server notifications such as tool-list changes. Creating an asynchronous task or calling an external provider may consume credits; reconnecting must query the existing task instead of submitting it again.
| 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 Example: {} |
maxTotalSaleGmvAmt | string | optional | Product total GMV (maximum). Max length 1000 Example: {} |
minTotalSaleGmv30dAmt | string | optional | Product total GMV (30-day) (minimum). Max length 1000 Example: {} |
maxTotalSaleGmv30dAmt | string | optional | Product total GMV (30-day) (maximum). Max length 1000 Example: {} |
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 |
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.total | integer | optional | Record count Example: 1 |
data.products | array | optional | Product information list (see below) Example: [] |
data.products[] | object | required | Item in data products. |
data.products[].productId | string | optional |
{
"pageSize": 10,
"keyword": "phone case",
"pageNumber": 1,
"region": "US"
}{
"data": {
"total": 1,
"products": [
{
"productId": "example-id",
"imageUrl": "https://example.com/image.jpg",
"coverUrl": "https://example.com/image.jpg",
"productImageUrls": [],
"categoryIds": [],
"region": "US",
"price": 1,
"minPrice": 1,
"maxPrice": 1,
"spuAvgPrice": 1,
"productRating": 1,
"reviewCount": 1,
"ratings": 1,
"productCommissionRate": 1,
"totalSaleCnt": 1,
"totalSale1dCnt": 1,
"totalSale7dCnt": 1,
"totalSale15dCnt": 1,
"totalSale30dCnt": 1,
"totalSale60dCnt": 1,
"totalSale90dCnt": 1,
"monthlySalesUnits": 1,
"totalSaleGmvAmt": 1,
"totalSaleGmv1dAmt": 1,
"totalSaleGmv7dAmt": 1,
"totalSaleGmv15dAmt": 1,
"totalSaleGmv30dAmt": 1,
"totalSaleGmv60dAmt": 1,
"totalSaleGmv90dAmt": 1,
"firstCrawlDt": 1,
"availableDate": "2026-01-01",
"salePropsInfo": [],
"asin": "B072MQ5BRX"
}
],
"columns": [],
"costToken": 1
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}data.products[].productName | string | optional | Product name Example: null |
data.products[].title | string | optional | Product name Example: null |
data.products[].imageUrl | string | optional | Product image URL Example: https://example.com/image.jpg |
data.products[].coverUrl | string | optional | Cover image URL list Example: https://example.com/image.jpg |
data.products[].productImageUrls | array | optional | Product image URL list Example: [] |
data.products[].categoryName | string | optional | Product category name Example: null |
data.products[].categoryIds | array | optional | Product category ID list Example: [] |
data.products[].region | string | optional | Region code Example: US |
data.products[].currency | string | optional | Currency Example: null |
data.products[].price | number | optional | Product price Example: 1 |
data.products[].minPrice | number | optional | Minimum price Example: 1 |
data.products[].maxPrice | number | optional | Maximum price Example: 1 |
data.products[].spuAvgPrice | number | optional | SPU average price Example: 1 |
data.products[].productRating | number | optional | Product rating Example: 1 |
data.products[].reviewCount | integer | optional | Review count Example: 1 |
data.products[].ratings | integer | optional | Review count Example: 1 |
data.products[].productCommissionRate | number | optional | Product commission rate Example: 1 |
data.products[].totalSaleCnt | integer | optional | Total sales Example: 1 |
data.products[].totalSale1dCnt | integer | optional | Total sales in 1 day Example: 1 |
data.products[].totalSale7dCnt | integer | optional | Total sales in 7 days Example: 1 |
data.products[].totalSale15dCnt | integer | optional | Total sales in 15 days Example: 1 |
data.products[].totalSale30dCnt | integer | optional | Total sales in 30 days Example: 1 |
data.products[].totalSale60dCnt | integer | optional | Total sales in 60 days Example: 1 |
data.products[].totalSale90dCnt | integer | optional | Total sales in 90 days Example: 1 |
data.products[].monthlySalesUnits | integer | optional | Monthly sales Example: 1 |
data.products[].totalSaleGmvAmt | number | optional | Total GMV Example: 1 |
data.products[].totalSaleGmv1dAmt | number | optional | Total GMV in 1 day Example: 1 |
data.products[].totalSaleGmv7dAmt | number | optional | Total GMV in 7 days Example: 1 |
data.products[].totalSaleGmv15dAmt | number | optional | Total GMV in 15 days Example: 1 |
data.products[].totalSaleGmv30dAmt | number | optional | Total GMV in 30 days Example: 1 |
data.products[].totalSaleGmv60dAmt | number | optional | Total GMV in 60 days Example: 1 |
data.products[].totalSaleGmv90dAmt | number | optional | Total GMV in 90 days Example: 1 |
data.products[].firstCrawlDt | integer | optional | Listing date Example: 1 |
data.products[].availableDate | string | optional | Listing time (timestamp) Example: 2026-01-01 |
data.products[].discount | string | optional | Discount info Example: null |
data.products[].freeShippingText | string | optional | Whether free shipping Example: null |
data.products[].offMarkText | string | optional | Whether there is a discount mark Example: null |
data.products[].salesFlagText | string | optional | Selling method Example: null |
data.products[].salesTrendFlagText | string | optional | Sales trend indicator Example: null |
data.products[].isSShopText | string | optional | Whether S store Example: null |
data.products[].salePropsInfo | array | optional | Sales property info (product specifications) Example: [] |
data.products[].sourceTool | string | optional | Source tool Example: null |
data.products[].sourceType | string | optional | Product source Example: null |
data.products[].asin | string | optional | Product ID Example: B072MQ5BRX |
data.columns | array | optional | Rendered columns Example: [] |
data.type | string | optional | Render style Example: null |
data.costToken | integer | optional | Token cost Example: 1 |
data.title | string | optional | Provider-specific response title. Example: null |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |