TikTok Intelligence ET

TikTok Intelligence ET: list Seller API

TikTok Intelligence ET: list Seller API.

MCP tool name

nexscope_data_et_list_seller

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-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_et_list_seller",
    "arguments": {
      "pageNum": 1,
      "pageSize": 20,
      "region": "US",
      "sellerSortField": 2,
      "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
`region`	`string`	required	area. 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: {}
`categoryId`	`string`	optional	Store-level category ID. Maximum length 1000 Example: {}
`categoryL2Id`	`string`	optional	Store secondary category ID. Maximum length 1000 Example: {}
`categoryL3Id`	`string`	optional	The third-level category ID of the store. Maximum length 1000 Example: {}
`minTotalSaleGmv30dAmt`	`number`	optional	GMV screening in the past 30 days (minimum value) Example: {}
`maxTotalSaleGmv30dAmt`	`number`	optional	GMV filtering in the past 30 days (maximum value) Example: {}
`salesTrendFlag`	`integer`	optional	Sales trend in the past 7 days: 0=stable, 1=increasing, 2=declining Example: {}
`fromFlag`	`integer`	optional	Store source: 1=local store, 2=cross-border store Example: {}
`salesFlag`	`integer`	optional	Main delivery methods: 1=video, 2=live broadcast Example: {}
`minFirstCrawlDt`	`integer`	optional	Estimated shelf time filter (minimum value), yyyyMMdd format (for example, 20240101 represents 2024-01-01) Example: {}
`maxFirstCrawlDt`	`integer`	optional	Estimated shelf time filter (maximum value), yyyyMMdd format Example: {}
`sellerSortField`	`integer`	optional	Sorting fields: 1=total sales (total_sale_cnt), 2=total sales (total_sale_gmv_amt), 3=average price of product SKU in the store (spu_avg_price) Example: 2
`sortType`	`integer`	optional	Sorting method: 0=ascending order (asc), 1=descending order (desc) Example: 1
`pageNum`	`integer`	optional	Pagination page number, starting from 1 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

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: {}
`sellers`	`array`	optional	Store list (see store fields below for details) Example: {}
`columns`	`array`	optional	Rendered columns Example: {}
`type`	`string`	optional	Rendering style Example: {}
`costToken`	`integer`	optional	Consume token Example: {}
`sellerId`	`string`	optional	Store ID Example: {}
`sellerName`	`string`	optional	Store name Example: {}
`sellerLink`	`string`	optional	Store link Example: {}
`coverUrl`	`string`	optional	Store cover address Example: {}
`region`	`string`	optional	area Example: {}
`categoryId`	`string`	optional	First level classification ID Example: {}
`categoryL2Id`	`string`	optional	Secondary classification ID Example: {}
`categoryL3Id`	`string`	optional	Third level classification ID Example: {}
`totalSaleCnt`	`integer`	optional	total sales Example: {}
`totalSale1dCnt`	`integer`	optional	Sales volume in the last day (incremental) Example: {}
`totalSale7dCnt`	`integer`	optional	Sales volume in the last 7 days (incremental) Example: {}
`totalSale30dCnt`	`integer`	optional	Sales volume in the last 30 days (incremental) Example: {}
`totalSale90dCnt`	`integer`	optional	Sales volume in the last 90 days (incremental) Example: {}
`totalSaleGmvAmt`	`number`	optional	total sales Example: {}
`totalSaleGmv1dAmt`	`number`	optional	Sales in the last day (incremental) Example: {}
`totalSaleGmv7dAmt`	`number`	optional	Sales in the last 7 days (incremental) Example: {}
`totalSaleGmv30dAmt`	`number`	optional	Sales in the last 30 days (incremental) Example: {}
`totalSaleGmv90dAmt`	`number`	optional	Sales in the last 90 days (incremental) Example: {}
`followersCount`	`integer`	optional	Number of fans Example: {}
`rating`	`number`	optional	Rating Example: {}
`reviewCount`	`integer`	optional	Number of reviews Example: {}
`positiveFeedbackRate`	`number`	optional	Positive rating Example: {}
`responseRate`	`number`	optional	response rate Example: {}
`deliveryRate`	`integer`	optional	Delivery rate Example: {}
`totalProductCnt`	`integer`	optional	Historical number of items in the store (including removal from shelves) Example: {}
`totalCrawlProductCnt`	`integer`	optional	Number of items in store Example: {}
`spuAvgPrice`	`number`	optional	Average price of product SKU in the store Example: {}
`minPrice`	`integer`	optional	lowest price Example: {}
`maxPrice`	`integer`	optional	highest price Example: {}
`totalIflCnt`	`integer`	optional	Total number of people carrying goods Example: {}
`totalVideoCnt`	`integer`	optional	Total number of videos delivered Example: {}
`totalLiveCnt`	`integer`	optional	Total live broadcasts Example: {}
`salesFlagText`	`string`	optional	Main delivery methods Example: {}
`salesTrendFlagText`	`string`	optional	sales trends Example: {}
`shopIdentityLabel`	`string`	optional	store logo Example: {}
`shopTypeText`	`string`	optional	Is it a brand store? Example: {}
`fromFlagText`	`string`	optional	Cross-border identification Example: {}
`productCategoryList`	`string`	optional	Product classification Example: {}
`mostProductCategoryList`	`string`	optional	TOP1 product classification Example: {}
`firstCrawlDt`	`integer`	optional	Estimated release time, yyyyMMdd format (for example, 20240101 represents 2024-01-01) Example: {}
`userId`	`string`	optional	Master UID Example: {}
`sourceType`	`string`	optional	Product source Example: {}

Examples

Example arguments

{
  "pageNum": 1,
  "pageSize": 20,
  "region": "US",
  "sellerSortField": 2,
  "sortType": 1
}

Example structuredContent

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