1688 Sourcing

1688 Bestselling Products MCP

Query 1688 bestseller charts for wholesale sourcing and product research. Call the 1688 Bestselling Products API via REST or MCP with your Nexscope API key.

CostRecent Avg. 19 · Range 10–19 credits / callOnline Test

1688 Bestselling Products AI Prompts & Use Cases

Examples for this tool are awaiting clarification. See the note below before using this route.

New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.

What You Need to Provide

These use cases need review because the documented tool contract has changed. Refer to Parameters & Response before preparing a request.

Step 1 · Connect

Connect Your AI Assistant

Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json

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

Using an API key? Get your key from API Access and include it in the Authorization header shown above.

Call this MCP tool

MCP tool name

nexscope_1688_product_billboard

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

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)
`sortType`	`string`	optional	Sort order: desc (descending), asc (ascending), default desc
`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)
`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
`endOfferCreateTime`	`string`	optional	Listing time (end), format: YYYY-MM-DD
`sendTime`	`string`	optional	Delivery time (multi-select), comma-separated. Options: 24 (24 hours), 48 (48 hours), 72 (72 hours)
`proxyRights`	`string`	optional	Dropship rights (multi-select), comma-separated. Options: 4360897 (one-piece dropship with free shipping), 449154 (procure now, pay later)
`shopService`	`string`	optional	Seller services (multi-select), comma-separated. Options: 4057409 (Safe Buy), 888777 (Deep Verification Report)
`buyerProtections`	`string`	optional	Buyer protections, comma-separated: free shipping, 7-day free return, or shipping insurance
`faceToFaceSupport`	`string`	optional	Waybill support (multi-select), comma-separated. Options: 441218 (Taobao), 386434 (Douyin), 422914 (Pinduoduo), 422978 (Xiaohongshu), 386370 (Kuaishou)
`productIds`	`string`	optional	Product IDs, separated by Chinese comma for multiple, max 20
`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
`code`	`integer`	optional	Nexscope transport/business envelope code; 0 means the request was processed. Inspect data for operation outcomes.
`cost`	`string`	optional	Processing time in milliseconds, not credits.
`data`	`object`	optional	Data value used by this API operation.
`data.columns`	`array`	optional	Render column definition
`data.columns[]`	`any`	required	Render column definition
`data.products`	`array`	optional	Products value used by this API operation.
`data.products[]`	`object`	required	Item in data products.
`data.products[].asin`	`string`	optional	Item number
`data.products[].asinUrl`	`string`	optional	Product link address
`data.products[].availableDate`	`string`	optional	Product shelf time, in the format of `yyyy-MM-dd HH:mm:ss`
`data.products[].company`	`string`	optional	Store name
`data.products[].consignPrice`	`number`	optional	Price on behalf of others
`data.products[].currency`	`string`	optional	Currency
`data.products[].dataType`	`string`	optional	Data type: `weeklyData` weekly data, `monthlyData` monthly data
`data.products[].deliveryTime`	`string`	optional	Shipping time
`data.products[].estimatedSalesAmount`	`integer`	optional	Estimated sales, returning corresponding values according to statistical period
`data.products[].imageUrl`	`string`	optional	Image address
`data.products[].levelName`	`string`	optional	Category level name
`data.products[].offerId`	`string`	optional	Product ID
`data.products[].price`	`number`	optional	wholesale price
`data.products[].quantityBegin`	`integer`	optional	Minimum batch size
`data.products[].quantityPrices`	`string`	optional	price range
`data.products[].salesOrderCount`	`integer`	optional	The number of sales, returns the corresponding value according to the statistical period
`data.products[].salesQuantity`	`integer`	optional	The number of pieces sold, returns the corresponding value according to the statistical period
`data.products[].shopId`	`string`	optional	Store ID
`data.products[].shopUrl`	`string`	optional	Store link address
`data.products[].sourceType`	`string`	optional	Source platform (1688)
`data.products[].title`	`string`	optional	Product title
`data.products[].unit`	`string`	optional	unit
`data.total`	`integer`	optional	Number of records
`data.type`	`string`	optional	rendering style
`msg`	`string \| null`	optional	Safe response message.
`time`	`string`	optional	Server response time.
`traceId`	`string \| null`	optional	Request trace identifier.
`ts`	`string`	optional	Server timestamp.

Example Q&A

Based on a published documentation sample, not a live tool call.

Your Question

What sales figures are available for the first product in this sample?

Example Answer

The first returned product, offer ID 921378745459, has a reported sales quantity of 1,095 and 730 sales orders in the documentation sample. Its estimated sales amount is 30,160 (reported currency: ¥).

About this sample: Figures apply to the sample’s reporting period, not current sales. The sales amount is an estimate, not profit or a verified payment total. One returned product does not represent the whole market.

View the Published Sample Data (JSON)

Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.

Data Example

Sample request and response

Request parameters

{
  "productIds": "921378745459",
  "pageType": 3,
  "date": "2026-03-01"
}

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 1,
    "columns": [
      {
        "filterable": true,
        "cellType": "text",
        "field": "dataType",
        "sortable": true,
        "title": "数据类型: weeklyData: 周数据; monthlyData: 月数据"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "offerId",
        "sortable": true,
        "title": "商品id"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "asin",
        "sortable": true,
        "title": "商品编号"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopId",
        "sortable": true,
        "title": "店铺id"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "imageUrl",
        "sortable": true,
        "title": "图片地址"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "availableDate",
        "sortable": true,
        "title": "商品上架时间，格式为 yyyy-MM-dd HH:mm:ss"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "quantityPrices",
        "sortable": true,
        "title": "价格区间"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "title",
        "sortable": true,
        "title": "商品标题"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "price",
        "sortable": true,
        "title": "批发价"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "deliveryTime",
        "sortable": true,
        "title": "发货时间"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "company",
        "sortable": true,
        "title": "店铺名称"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "salesQuantity",
        "sortable": true,
        "title": "销售件数（按统计周期返回对应的值）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "salesOrderCount",
        "sortable": true,
        "title": "销售笔数（按统计周期返回对应的值）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "estimatedSalesAmount",
        "sortable": true,
        "title": "预估销售额（按统计周期返回对应的值）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "consignPrice",
        "sortable": true,
        "title": "代发价"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "unit",
        "sortable": true,
        "title": "单位"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "quantityBegin",
        "sortable": true,
        "title": "起批量"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "levelName",
        "sortable": true,
        "title": "类目层级名称"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopUrl",
        "sortable": true,
        "title": "店铺链接地址"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "asinUrl",
        "sortable": true,
        "title": "商品链接地址"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceType",
        "sortable": true,
        "title": "1688"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "currency",
        "sortable": true,
        "title": "币种"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceTool",
        "sortable": true,
        "title": "来源工具"
      }
    ],
    "type": "productWorkbenches",
    "products": [
      {
        "salesOrderCount": 730,
        "deliveryTime": "48",
        "dataType": "monthlyData",
        "quantityBegin": 1,
        "availableDate": "2025-05-08 14:29:00",
        "levelName": "服饰配件、饰品>腰带/腰链/腰封>腰带",
        "title": "头层牛皮针扣皮带男款 复古百搭牛仔裤带 简约休闲真皮腰带男士",
        "shopUrl": "https://shop2950j93562603.1688.com",
        "asinUrl": "https://detail.1688.com/offer/921378745459.html",
        "estimatedSalesAmount": 30160,
        "consignPrice": 29,
        "unit": "条",
        "sourceTool": "店雷达-1688选品库",
        "sourceType": "1688",
        "price": 27,
        "salesQuantity": 1095,
        "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01gFfkRz2DrFmBYU9Xs_!!2206775498662-0-cib.jpg",
        "offerId": "921378745459",
        "asin": "921378745459",
        "company": "广州花都区壹友皮具厂",
        "currency": "¥",
        "shopId": "b2b-2206775498662258ae",
        "quantityPrices": "[{\"quantity\":\"1~499\",\"value\":\"29.00\"},{\"quantity\":\"500~999\",\"value\":\"28.00\"},{\"quantity\":\"≥1000\",\"value\":\"27.00\"}]"
      }
    ]
  }
}

View the MCP Request & Response Format

Examples

The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.

MCP Request

{
  "jsonrpc": "2.0",
  "id": "1688-product-billboard-example",
  "method": "tools/call",
  "params": {
    "name": "nexscope_1688_product_billboard",
    "arguments": {
      "date": "2026-07-01",
      "keyWord": "手机壳",
      "pageIndex": 1,
      "pageSize": 20,
      "pageType": 3,
      "searchType": 1
    }
  }
}

MCP Response Format

{
  "jsonrpc": "2.0",
  "id": "1688-product-billboard-example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"code\":0,\"cost\":\"0\",\"data\":{\"products\":[{\"currency\":\"CNY\",\"offerId\":\"1234567890123456789\",\"price\":4.2,\"title\":\"Example product\"}],\"total\":1,\"columns\":[]},\"msg\":null,\"time\":\"2026-10-20T00:00:00Z\",\"traceId\":null,\"ts\":\"0\"}"
      }
    ],
    "structuredContent": {
      "code": 0,
      "cost": "0",
      "data": {
        "products": [
          {
            "currency": "CNY",
            "offerId": "1234567890123456789",
            "price": 4.2,
            "title": "Example product"
          }
        ],
        "total": 1,
        "columns": []
      },
      "msg": null,
      "time": "2026-10-20T00:00:00Z",
      "traceId": null,
      "ts": "0"
    },
    "isError": false
  }
}