TikTok Intelligence ET

TikTok Intelligence ET: list Product API

TikTok Intelligence ET: list Product API.

MCP tool name

nexscope_data_et_list_product

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "data-et-list-product-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_et_list_product",
    "arguments": {
      "keyword": "phone case",
      "minTotalSale30dCnt": 1000,
      "pageSize": 20,
      "productSortField": 5,
      "region": "US",
      "sortType": 1
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress 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 keywords (please translate into local language). Maximum length 1000 Example: {}
`region`	`string`	optional	Region, default `US`. Optional values: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (UK), 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 classification (please enter Chinese). Maximum length 1000 Example: {}
`minTotalSaleCnt`	`integer`	optional	Total sales (minimum value) Example: {}
`maxTotalSaleCnt`	`integer`	optional	Total sales (maximum) Example: {}
`minTotalSale30dCnt`	`integer`	optional	30-day sales (minimum) Example: {}
`maxTotalSale30dCnt`	`integer`	optional	30-day sales (maximum) Example: {}
`minTotalSaleGmvAmt`	`string`	optional	GMV (minimum value). Maximum length 1000 Example: {}
`maxTotalSaleGmvAmt`	`string`	optional	GMV (maximum value). Maximum length 1000 Example: {}
`minTotalSaleGmv30dAmt`	`string`	optional	GMV (30 days) (minimum). Maximum length 1000 Example: {}
`maxTotalSaleGmv30dAmt`	`string`	optional	GMV (30 days) (maximum). Maximum length 1000 Example: {}
`minSpuAvgPrice`	`number`	optional	SPU average price (minimum value) Example: {}
`maxSpuAvgPrice`	`number`	optional	SPU average price (maximum) Example: {}
`minProductRating`	`number`	optional	Product rating (minimum value) Example: {}
`maxProductRating`	`number`	optional	Product rating (maximum value) Example: {}
`minReviewCount`	`integer`	optional	Number of product reviews (minimum value) Example: {}
`maxReviewCount`	`integer`	optional	Number of product reviews (maximum) Example: {}
`minProductCommissionRate`	`number`	optional	Product commission ratio (minimum value), when the input value is a percentage, it will automatically be converted into a decimal, for example: 5%->0.05 Example: {}
`maxProductCommissionRate`	`number`	optional	Product commission ratio (maximum value), when the input value is a percentage, it will automatically be converted into a decimal, for example: 5%->0.05 Example: {}
`minTotalIflCnt`	`integer`	optional	Number of people carrying goods (minimum) Example: {}
`maxTotalIflCnt`	`integer`	optional	Number of people carrying goods (maximum) Example: {}
`minTotalVideoCnt`	`integer`	optional	Number of videos with goods (minimum) Example: {}
`maxTotalVideoCnt`	`integer`	optional	Number of videos with goods (maximum value) Example: {}
`minTotalViewsCnt`	`integer`	optional	Number of plays with goods (minimum value) Example: {}
`maxTotalViewsCnt`	`integer`	optional	Number of plays with goods (maximum value) Example: {}
`minFirstCrawlDt`	`integer`	optional	Product shelf time (minimum value), format YYYYMMDD (for example: 20200101 represents 2020-01-01) Example: {}
`maxFirstCrawlDt`	`integer`	optional	Product shelf time (maximum value), format YYYYMMDD Example: {}
`saleDays`	`integer`	optional	The number of days the product has been on sale, in days Example: {}
`productSortField`	`integer`	optional	Sorting fields: 1=total sales volume, 2=total merchandise transaction volume, 3=SPU average price, 4=7-day sales volume, 5=30-day sales volume, 6=7-day merchandise transaction volume, 7=30-day merchandise transaction volume. Default `1` Example: 1
`sortType`	`integer`	optional	Sorting method: 0=ascending order (asc), 1=descending order (desc). Default `1` Example: 1
`pageNum`	`integer`	optional	Pagination page number. Default `1` Example: 1
`pageSize`	`integer`	optional	Number of items per page. Default `50` Example: 50

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Number of records Example: {}
`products`	`array`	optional	Product information list (see details below) Example: {}
`columns`	`array`	optional	Rendered columns Example: {}
`type`	`string`	optional	Rendering style Example: {}
`costToken`	`integer`	optional	Consume token Example: {}
`productId`	`string`	optional	Product unique identification ID Example: {}
`productName`	`string`	optional	Product name Example: {}
`title`	`string`	optional	Product name Example: {}
`imageUrl`	`string`	optional	Product image URL Example: {}
`coverUrl`	`string`	optional	Cover image URL list Example: {}
`productImageUrls`	`array`	optional	Product image URL list Example: {}
`categoryName`	`string`	optional	Product category name Example: {}
`categoryIds`	`array`	optional	Product category ID list Example: {}
`region`	`string`	optional	area code Example: {}
`currency`	`string`	optional	Currency Example: {}
`price`	`number`	optional	Product price Example: {}
`minPrice`	`number`	optional	lowest price Example: {}
`maxPrice`	`number`	optional	highest price Example: {}
`spuAvgPrice`	`number`	optional	SPU average price Example: {}
`productRating`	`number`	optional	product rating Example: {}
`reviewCount`	`integer`	optional	Number of comments Example: {}
`ratings`	`integer`	optional	Number of comments Example: {}
`productCommissionRate`	`number`	optional	Product commission ratio Example: {}
`totalSaleCnt`	`integer`	optional	total sales Example: {}
`totalSale1dCnt`	`integer`	optional	Total sales in 1 day Example: {}
`totalSale7dCnt`	`integer`	optional	Total sales within 7 days Example: {}
`totalSale15dCnt`	`integer`	optional	Total sales within 15 days Example: {}
`totalSale30dCnt`	`integer`	optional	Total sales within 30 days Example: {}
`totalSale60dCnt`	`integer`	optional	Total sales within 60 days Example: {}
`totalSale90dCnt`	`integer`	optional	Total sales in 90 days Example: {}
`monthlySalesUnits`	`integer`	optional	monthly sales Example: {}
`totalSaleGmvAmt`	`number`	optional	total sales Example: {}
`totalSaleGmv1dAmt`	`number`	optional	Total sales in 1 day Example: {}
`totalSaleGmv7dAmt`	`number`	optional	Total sales within 7 days Example: {}
`totalSaleGmv15dAmt`	`number`	optional	Total sales in 15 days Example: {}
`totalSaleGmv30dAmt`	`number`	optional	Total sales in 30 days Example: {}
`totalSaleGmv60dAmt`	`number`	optional	Total sales in 60 days Example: {}
`totalSaleGmv90dAmt`	`number`	optional	Total sales in 90 days Example: {}
`firstCrawlDt`	`integer`	optional	Release date Example: {}
`availableDate`	`string`	optional	Release time (timestamp) Example: {}
`discount`	`string`	optional	discount information Example: {}
`freeShippingText`	`string`	optional	Is it free shipping? Example: {}
`offMarkText`	`string`	optional	Is there a discount mark? Example: {}
`salesFlagText`	`string`	optional	How to bring goods Example: {}
`salesTrendFlagText`	`string`	optional	sales trend tag Example: {}
`isSShopText`	`string`	optional	Is it an S store? Example: {}
`salePropsInfo`	`array`	optional	Sales attribute information (product specifications) Example: {}
`sourceType`	`string`	optional	Product source Example: {}
`asin`	`string`	optional	Product ID Example: {}

Examples

Example arguments

{
  "keyword": "phone case",
  "minTotalSale30dCnt": 1000,
  "pageSize": 20,
  "productSortField": 5,
  "region": "US",
  "sortType": 1
}

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}