1688 Sourcing

1688 Sourcing: product Search API

1688 Sourcing: product Search API.

MCP tool name

nexscope_data_dl_product_search

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-dl-product-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_dl_product_search",
    "arguments": {
      "cycle": "30",
      "keyWord": "yoga mat",
      "pageSize": 20,
      "sortField": "saleCount30d",
      "sortType": "desc"
    }
  }
}

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	Search keyword, must be in Chinese, maximum 50 characters Example: {}
`goodsUrl`	`string`	optional	Product link address, choose one from `keyWord` Example: {}
`productIds`	`string`	optional	Product ID, multiple separated by commas, up to 20 Example: {}
`cycle`	`string`	optional	Statistical period: `7` last 7 days or `30` last 30 days Example: {}
`searchType`	`integer`	optional	Search type: `1` fuzzy matching, `3` precise matching Example: 1
`sortField`	`string`	optional	`orderCount7d`、`saleCount7d`、`saleVolume7d`、`orderCount30d`、`saleCount30d`、`saleVolume30d`、`offerCreateTime`、`price`、`consignPrice` Example: orderCount30d
`sortType`	`string`	optional	Sorting type: `desc` descending order, `asc` ascending order Example: desc
`pageIndex`	`integer`	optional	Page number, starting from 1 Example: 1
`pageSize`	`integer`	optional	Quantity per page, range 10-100 Example: 20
`beginPrice`	`number`	optional	Wholesale price starting value Example: {}
`endPrice`	`number`	optional	wholesale price ending value Example: {}
`beginConsignPrice`	`number`	optional	Starting value of agency price Example: {}
`endConsignPrice`	`number`	optional	The end value of the agency price Example: {}
`beginOrderCount`	`integer`	optional	Starting value of number of sales Example: {}
`endOrderCount`	`integer`	optional	Sales end value Example: {}
`beginSaleCount`	`integer`	optional	Starting value of sales units Example: {}
`endSaleCount`	`integer`	optional	Sales end value Example: {}
`beginSaleVolume`	`number`	optional	sales starting value Example: {}
`endSaleVolume`	`number`	optional	sales end value Example: {}
`beginStartQuantity`	`integer`	optional	Starting value of minimum purchase quantity Example: {}
`endStartQuantity`	`integer`	optional	Minimum purchase quantity end value Example: {}
`beginTpYear`	`integer`	optional	Starting value of the credit pass period Example: {}
`endTpYear`	`integer`	optional	Integrity Pass life end value Example: {}
`beginOfferCreateTime`	`string`	optional	Starting value of shelf time, format `YYYY-MM-DD` Example: {}
`endOfferCreateTime`	`string`	optional	Shelf time end value, format `YYYY-MM-DD` Example: {}
`companyType`	`integer`	optional	Company type: `0` unlimited, `1` shop, `2` factory Example: 0
`offerType`	`integer`	optional	Product identification: `0` is not limited, `2` is new, `3` is 1688 carefully selected, `4` is cross-border, `5` supports customization, `6` is the treasure of the store Example: 0
`shiLiType`	`string`	optional	Seller type, multiple selections separated by commas: `superFactory`, `Power`, `TrustPass` Example: {}
`sendTime`	`string`	optional	Shipping time, multiple selections separated by commas: `24`, `48`, `72` Example: {}
`faceToFaceSupport`	`string`	optional	Farewell support, multiple selections separated by commas: `441218` Taobao, `386434` Douyin, `422914` Pinduoduo, `422978` Xiaohongshu, `386370` Kuaishou Example: {}
`proxyRights`	`string`	optional	For drop-shipping rights, multiple options must be separated by commas: `4360897`, free shipping for one piece, `449154`, purchase first, pay later Example: {}
`shopService`	`string`	optional	Seller services, multiple selections separated by commas: `4057409` Safe Purchase, `888777` In-depth Certification Report Example: {}
`buyerProtections`	`string`	optional	Rights protection, separate multiple choices with commas: `Free shipping for goods`, `7-day return guarantee`, `Support freight insurance` Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Total number of records Example: {}
`type`	`string`	optional	rendering style Example: {}
`columns`	`array`	optional	Render column definition Example: {}
`products`	`array`	optional	Product list Example: {}
`offerId`	`string`	optional	Product ID Example: {}
`asin`	`string`	optional	Item number Example: {}
`title`	`string`	optional	Product title Example: {}
`asinUrl`	`string`	optional	Product link address Example: {}
`imageUrl`	`string`	optional	Product picture address Example: {}
`price`	`number`	optional	wholesale price Example: {}
`consignPrice`	`number`	optional	Price on behalf of others Example: {}
`quantityPrices`	`string`	optional	price range Example: {}
`quantityBegin`	`integer`	optional	Minimum batch size Example: {}
`unit`	`string`	optional	unit Example: {}
`currency`	`string`	optional	Currency Example: {}
`salesOrderCount`	`integer`	optional	Number of sales, returned according to statistical period Example: {}
`salesQuantity`	`integer`	optional	Number of pieces sold, returned according to statistical period Example: {}
`estimatedSalesAmount`	`integer`	optional	Estimated sales, returned according to statistical period Example: {}
`deliveryTime`	`string`	optional	Shipping time Example: {}
`availableDate`	`string`	optional	Product shelf time Example: {}
`levelName`	`string`	optional	Category level name Example: {}
`company`	`string`	optional	Store name Example: {}
`shopId`	`string`	optional	Store ID Example: {}
`shopUrl`	`string`	optional	Store link address Example: {}
`dataType`	`string`	optional	Data type: `weeklyData` weekly data, `monthlyData` monthly data Example: {}
`sourceType`	`string`	optional	Source platform (1688) Example: {}

Examples

Example arguments

{
  "cycle": "30",
  "keyWord": "yoga mat",
  "pageSize": 20,
  "sortField": "saleCount30d",
  "sortType": "desc"
}

Example structuredContent

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