1688 Sourcing

1688 Bestselling Products

Query 1688 bestseller charts for wholesale sourcing and product research. Call the 1688 Bestselling Products API via REST or MCP from 12 credits per call.

MCP tool name

nexscope_1688_product_billboard

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-billboard-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_1688_product_billboard",
    "arguments": {
      "date": "2026-07-01",
      "keyWord": "手机壳",
      "pageIndex": 1,
      "pageSize": 20,
      "pageType": 3,
      "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	Product search keyword (must be written in Simplified Chinese; translate it before calling this API). Maximum 50 characters Example: 手机壳
`date`	`string`	optional	Query time. Weekly chart: pass the Sunday date of that week, e.g. 2025-06-15 (up to 90 days); Monthly chart: pass the first day of the month, e.g. 2025-06-01 (up to one year) Example: 2026-07-01
`pageType`	`integer`	optional	Billboard type: 2 = weekly, 3 = monthly. Default 3 Example: 3
`pageIndex`	`integer`	optional	Page number (starting from 1), default 1 Example: 1
`pageSize`	`integer`	optional	Number of results per page (10-100), default 20 Example: 20
`sortField`	`string`	optional	Sort field, default orderCount. Options: orderCount (order count), saleCount (units sold), saleVolume (estimated sales amount), offerCreateTime (listing time), price (wholesale price), consignPrice (dropship price) Example: {}
`sortType`	`string`	optional	Sort order: desc (descending), asc (ascending), default desc Example: {}
`searchType`	`integer`	optional	Product keyword search type: 1 = fuzzy match, 3 = exact match. Default 1 Example: 1
`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
`companyType`	`integer`	optional	Company type: 0 = no limit, 1 = store, 2 = factory Example: 0
`shiLiType`	`string`	optional	Seller membership type (multi-select), comma-separated. Options: superFactory (Super Factory), Power (Power Seller), TrustPass (TrustPass member only) Example: {}
`beginTpYear`	`integer`	optional	Start TrustPass years Example: 1
`endTpYear`	`integer`	optional	End TrustPass years Example: 1
`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 order quantity (start) Example: 1
`endStartQuantity`	`integer`	optional	Minimum order quantity (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: {}
`sendTime`	`string`	optional	Delivery time (multi-select), comma-separated. Options: 24 (24 hours), 48 (48 hours), 72 (72 hours) Example: {}
`proxyRights`	`string`	optional	Dropship rights (multi-select), comma-separated. Options: 4360897 (one-piece dropship with free shipping), 449154 (procure now, pay later) Example: {}
`shopService`	`string`	optional	Seller services (multi-select), comma-separated. Options: 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: {}
`faceToFaceSupport`	`string`	optional	Waybill support (multi-select), comma-separated. Options: 441218 (Taobao), 386434 (Douyin), 422914 (Pinduoduo), 422978 (Xiaohongshu), 386370 (Kuaishou) Example: {}
`productIds`	`string`	optional	Product IDs, separated by Chinese comma for multiple, max 20 Example: {}
`goodsUrl`	`string`	optional	Product link URL Example: https://example.com/image.jpg

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	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: {}
`price`	`number`	optional	wholesale price Example: {}
`consignPrice`	`number`	optional	Price on behalf of others Example: {}
`currency`	`string`	optional	Currency Example: {}
`unit`	`string`	optional	unit Example: {}
`quantityBegin`	`integer`	optional	Minimum batch size Example: {}
`quantityPrices`	`string`	optional	price range Example: {}
`salesOrderCount`	`integer`	optional	The number of sales, returns the corresponding value according to the statistical period Example: {}
`salesQuantity`	`integer`	optional	The number of pieces sold, returns the corresponding value according to the statistical period Example: {}
`estimatedSalesAmount`	`integer`	optional	Estimated sales, returning corresponding values according to statistical period Example: {}
`dataType`	`string`	optional	Data type: `weeklyData` weekly data, `monthlyData` monthly data Example: {}
`availableDate`	`string`	optional	Product shelf time, in the format of `yyyy-MM-dd HH:mm:ss` Example: {}
`deliveryTime`	`string`	optional	Shipping 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: {}
`asinUrl`	`string`	optional	Product link address Example: {}
`imageUrl`	`string`	optional	Image address Example: {}
`sourceType`	`string`	optional	Source platform (1688) Example: {}

Examples

Example arguments

{
  "date": "2026-07-01",
  "keyWord": "手机壳",
  "pageIndex": 1,
  "pageSize": 20,
  "pageType": 3,
  "searchType": 1
}

Example structuredContent

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