TikTok Intelligence ET

TikTok Intelligence ET: list Seller Product API

TikTok Intelligence ET: list Seller Product API.

MCP tool name

nexscope_data_et_list_seller_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-seller-product-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_et_list_seller_product",
    "arguments": {
      "pageNum": 1,
      "pageSize": 20,
      "sellerId": "7495514739648989419",
      "sellerProductSortField": 1,
      "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
`sellerId`	`string`	required	Store ID (TikTok Shop store ID). Maximum length 1000. Obtained from the returned results of the "ET TikTok Store Search" or "ET TikTok Store Details" skills Example: {}
`sellerProductSortField`	`integer`	optional	List sorting fields: 1=Total sales (total_sale_cnt), 2=Total sales (total_sale_gmv_amt), 3=SPU average price (spu_avg_price), 4=7-day sales (total_sale_7d_cnt), 5=7-day sales (total_sale_gmv_7d_amt) Example: 1
`sortType`	`integer`	optional	Sorting order: 0=ascending (asc), 1=descending (desc) Example: 1
`pageSize`	`integer`	optional	Number of items per page. must be a multiple of 10, the maximum is 100; the upper limit of a single page in the official interface is 10, internally it is 10 after multiple pulls per page and then merged Example: 50
`pageNum`	`integer`	optional	Pagination page number, starting from 1 Example: 1

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`errcode`	`integer`	optional	Business status code, 200 indicates success (see error code below for details) Example: {}
`errmsg`	`string`	optional	Business status description Example: {}
`total`	`integer`	optional	Number of records Example: {}
`products`	`array`	optional	Store product list (see product fields below for details) 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: {}
`asin`	`string`	optional	Product ID (same as productId) Example: {}
`imageUrl`	`string`	optional	Product image URL Example: {}
`coverUrl`	`string`	optional	Cover image URL Example: {}
`productImageUrls`	`array`	optional	Product image URL list Example: {}
`price`	`number`	optional	Product price Example: {}
`spuAvgPrice`	`number`	optional	SPU average price Example: {}
`minPrice`	`number`	optional	lowest price Example: {}
`maxPrice`	`number`	optional	highest price Example: {}
`currency`	`string`	optional	Currency Example: {}
`totalSaleCnt`	`integer`	optional	total sales Example: {}
`totalSale1dCnt`	`integer`	optional	Total sales in 1 day (incremental) Example: {}
`totalSale7dCnt`	`integer`	optional	Total sales within 7 days (incremental) Example: {}
`totalSale15dCnt`	`integer`	optional	Total sales (incremental) within 15 days Example: {}
`totalSale30dCnt`	`integer`	optional	Total sales in 30 days (incremental) Example: {}
`totalSale60dCnt`	`integer`	optional	Total sales in 60 days (incremental) Example: {}
`totalSale90dCnt`	`integer`	optional	Total sales in 90 days (incremental) Example: {}
`monthlySalesUnits`	`integer`	optional	monthly sales Example: {}
`totalSaleGmvAmt`	`number`	optional	total sales Example: {}
`totalSaleGmv1dAmt`	`number`	optional	Total sales in 1 day (incremental) Example: {}
`totalSaleGmv7dAmt`	`number`	optional	Total sales (incremental) within 7 days Example: {}
`totalSaleGmv15dAmt`	`number`	optional	Total sales in 15 days (incremental) Example: {}
`totalSaleGmv30dAmt`	`number`	optional	Total sales in 30 days (incremental) Example: {}
`totalSaleGmv60dAmt`	`number`	optional	Total sales in 60 days (incremental) Example: {}
`totalSaleGmv90dAmt`	`number`	optional	Total sales in 90 days (incremental) Example: {}
`productRating`	`number`	optional	product rating Example: {}
`ratings`	`integer`	optional	Number of comments Example: {}
`reviewCount`	`integer`	optional	Number of comments Example: {}
`productCommissionRate`	`number`	optional	Product commission ratio (decimal, such as 0.05 means 5%) Example: {}
`categoryName`	`string`	optional	Product category name Example: {}
`categoryIds`	`array`	optional	Product category ID list Example: {}
`salesFlagText`	`string`	optional	How to bring goods Example: {}
`salesTrendFlagText`	`string`	optional	sales trend tag Example: {}
`firstCrawlDt`	`integer`	optional	Release date (yyyyMMdd format, such as 20240504) Example: {}
`availableDate`	`string`	optional	Release time (timestamp/date) Example: {}
`discount`	`string`	optional	discount information Example: {}
`offMarkText`	`string`	optional	Is there a discount mark? Example: {}
`freeShippingText`	`string`	optional	Is it free shipping? Example: {}
`isSShopText`	`string`	optional	Is it an S store? Example: {}
`salePropsInfo`	`array`	optional	Sales attribute information (including propId/propName/salePropValues[propValueId/propValue/image]) Example: {}
`region`	`string`	optional	area code Example: {}
`sourceType`	`string`	optional	Product source Example: {}

Examples

Example arguments

{
  "pageNum": 1,
  "pageSize": 20,
  "sellerId": "7495514739648989419",
  "sellerProductSortField": 1,
  "sortType": 1
}

Example structuredContent

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