1688 Sourcing

1688 Product Search

Search 1688 wholesale products for sourcing, supplier discovery, and product selection across Alibaba's domestic B2B marketplace. Call it via REST API or MCP.

MCP tool name

nexscope_1688_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": "1688-product-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_1688_product_search",
    "arguments": {
      "keyWord": "瑜伽垫",
      "pageIndex": 1,
      "pageSize": 20,
      "searchType": 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	Search keyword (must be written in Simplified Chinese; maximum 50 characters) Example: 瑜伽垫
`goodsUrl`	`string`	optional	Product link URL (mutually exclusive with keyWord) Example: https://example.com/image.jpg
`productIds`	`string`	optional	Product IDs, separated by the Chinese enumeration comma (、), max 20 Example: {}
`cycle`	`string`	optional	Statistical period: 7 (last 7 days) or 30 (last 30 days) Example: {}
`searchType`	`integer`	optional	Search type: 1 = fuzzy match, 3 = exact match Example: 1
`sortField`	`string`	optional	Sort field: orderCount7d, saleCount7d, saleVolume7d, orderCount30d, saleCount30d, saleVolume30d, offerCreateTime, price, consignPrice. Default orderCount30d Example: orderCount30d
`sortType`	`string`	optional	Sort order: desc (descending), asc (ascending). Default desc Example: desc
`pageIndex`	`integer`	optional	Page number (starting from 1) Example: 1
`pageSize`	`integer`	optional	Results per page (10-100), default 20 Example: 20
`beginPrice`	`number`	optional	Wholesale price (start) Example: 1
`endPrice`	`number`	optional	Wholesale price (end) Example: 1
`beginConsignPrice`	`number`	optional	Dropship price (start) Example: 1
`endConsignPrice`	`number`	optional	Dropship price (end) Example: 1
`beginOrderCount`	`integer`	optional	Order count (start) Example: 1
`endOrderCount`	`integer`	optional	Order count (end) Example: 1
`beginSaleCount`	`integer`	optional	Units sold (start) Example: 1
`endSaleCount`	`integer`	optional	Units sold (end) Example: 1
`beginSaleVolume`	`number`	optional	Sales amount (start) Example: 1
`endSaleVolume`	`number`	optional	Sales amount (end) Example: 1
`beginStartQuantity`	`integer`	optional	Minimum purchase quantity (start) Example: 1
`endStartQuantity`	`integer`	optional	Minimum purchase quantity (end) Example: 1
`beginTpYear`	`integer`	optional	TrustPass years (start) Example: 1
`endTpYear`	`integer`	optional	TrustPass years (end) Example: 1
`beginOfferCreateTime`	`string`	optional	Listing time start (format: YYYY-MM-DD) Example: {}
`endOfferCreateTime`	`string`	optional	Listing time end (format: YYYY-MM-DD) Example: {}
`companyType`	`integer`	optional	Company type: 0 = no limit, 1 = store, 2 = factory. Default 0 Example: 0
`offerType`	`integer`	optional	Product tag: 0 = no limit, 2 = new product, 3 = 1688 Select, 4 = cross-border, 5 = customization supported, 6 = store highlight. Default 0 Example: 0
`shiLiType`	`string`	optional	Seller type (multi-select, comma-separated): superFactory (Super Factory), Power (Power Seller), TrustPass (TrustPass) Example: {}
`sendTime`	`string`	optional	Delivery time (multi-select, comma-separated): 24, 48, 72 Example: {}
`faceToFaceSupport`	`string`	optional	Waybill support (multi-select, comma-separated): 441218 (Taobao), 386434 (Douyin), 422914 (Pinduoduo), 422978 (Xiaohongshu), 386370 (Kuaishou) Example: {}
`proxyRights`	`string`	optional	Dropship rights (multi-select, comma-separated): 4360897 (one-piece dropship with free shipping), 449154 (procure now, pay later) Example: {}
`shopService`	`string`	optional	Seller services (multi-select, comma-separated): 4057409 (Safe Buy), 888777 (Deep Verification Report) Example: {}
`buyerProtections`	`string`	optional	Buyer protections, comma-separated: free shipping, 7-day free return, or shipping 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

{
  "keyWord": "瑜伽垫",
  "pageIndex": 1,
  "pageSize": 20,
  "searchType": 1
}

Example structuredContent

{}