1688
Query 1688 product bestseller billboard data for sourcing discovery and wholesale product research.
nexscope_1688_product_billboardhttps://api.nexscope.ai/api/skill-api/v2/mcptools/callUse OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope for standard remote clients. API keys remain supported as a compatibility option while v1 integrations migrate.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.
Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/api/skill-api/v2/mcp, then use tools/call with the MCP tool name below. The arguments object should match the table on this page.
{
"jsonrpc": "2.0",
"id": "1688-product-billboard-1",
"method": "tools/call",
"params": {
"name": "nexscope_1688_product_billboard",
"arguments": {
"keyWord": "手机壳",
"pageIndex": 1,
"searchType": 1,
"pageType": 3,
"pageSize": 20,
"date": "2026-07-01"
}
}
}MCP 2025-11-25 · Streamable HTTPhttps://www.nexscope.ai/mcp-map/1688-product-billboardProgress is delivered on the original POST SSE response when the client supplies a progress token and the tool has real execution stages. GET SSE carries server notifications such as tool-list changes. Creating an asynchronous task or calling an external provider may consume credits; reconnecting must query the existing task instead of submitting it again.
| 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 |
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.total | integer | optional | Total record count Example: 1 |
data.type | string | optional | Render style Example: null |
data.columns | array | optional | Render columns Example: [] |
data.products | array | optional |
{
"keyWord": "手机壳",
"pageIndex": 1,
"searchType": 1,
"pageType": 3,
"pageSize": 20,
"date": "2026-07-01"
}{
"data": {
"total": 1,
"columns": [],
"products": [
{
"offerId": "example-id",
"asin": "B072MQ5BRX",
"price": 1,
"consignPrice": 1,
"quantityBegin": 1,
"salesOrderCount": 1,
"salesQuantity": 1,
"estimatedSalesAmount": 1,
"availableDate": "2026-01-01",
"shopId": "example-id",
"shopUrl": "https://example.com/image.jpg",
"asinUrl": "https://detail.1688.com/offer/1040473674152.html",
"imageUrl": "https://example.com/image.jpg"
}
]
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}Product list (see Product Object below) Example: [] |
data.products[] | object | required | Item in data products. |
data.products[].offerId | string | optional | Product ID Example: example-id |
data.products[].asin | string | optional | Product number Example: B072MQ5BRX |
data.products[].title | string | optional | Product title Example: null |
data.products[].price | number | optional | Wholesale price Example: 1 |
data.products[].consignPrice | number | optional | Dropship price Example: 1 |
data.products[].currency | string | optional | Currency Example: null |
data.products[].unit | string | optional | Unit Example: null |
data.products[].quantityBegin | integer | optional | Minimum order quantity Example: 1 |
data.products[].quantityPrices | string | optional | Price range Example: null |
data.products[].salesOrderCount | integer | optional | Order count (returns corresponding value based on statistical period) Example: 1 |
data.products[].salesQuantity | integer | optional | Units sold (returns corresponding value based on statistical period) Example: 1 |
data.products[].estimatedSalesAmount | integer | optional | Estimated sales amount (returns corresponding value based on statistical period) Example: 1 |
data.products[].dataType | string | optional | Data type: weeklyData = weekly data, monthlyData = monthly data Example: null |
data.products[].availableDate | string | optional | Product listing time, format yyyy-MM-dd HH:mm:ss Example: 2026-01-01 |
data.products[].deliveryTime | string | optional | Delivery time Example: null |
data.products[].levelName | string | optional | Category hierarchy name Example: null |
data.products[].company | string | optional | Store name Example: null |
data.products[].shopId | string | optional | Store ID Example: example-id |
data.products[].shopUrl | string | optional | Store link URL Example: https://example.com/image.jpg |
data.products[].asinUrl | string | optional | Product link URL Example: https://detail.1688.com/offer/1040473674152.html |
data.products[].imageUrl | string | optional | Image URL Example: https://example.com/image.jpg |
data.products[].sourceType | string | optional | Source platform (1688) Example: null |
data.products[].sourceTool | string | optional | Source tool Example: null |
data.title | string | optional | Provider-specific response title. Example: null |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.costToken | integer | optional | Token cost reported by the upstream provider. Example: null |
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |