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.
1688 Bestselling Products AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
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.
1. Check 1688 Bestsellers
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Show the available results and clearly identify missing information.
2. Find Bestsellers By Product ID
Prompt: Check 1688 Bestsellers using [product IDs]. Keep the returned results tied to that input and do not infer matches that were not returned.
3. Find Bestsellers By Product Link
Prompt: Check 1688 Bestsellers using [product link]. Keep the returned results tied to that input and do not infer matches that were not returned.
4. Review A Specific Reporting Period
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Use [my chosen reporting period] and show the period with the returned figures. Keep dated snapshots distinct from current data.
5. Continue The Results Within A Page Limit
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Start at [my selected page] and return [my requested page size] within the documented limits. Ask before requesting another page and do not describe one page as the complete dataset.
6. Prioritize The Results For Review
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Prioritize [my chosen ranking metric] in [my chosen order]. Keep the ranking limited to the selected filters and reporting period. For this selection, choose order count, units sold, estimated sales amount, listing time, wholesale price or dropship price.
7. Find Matches By Trustpass Years
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Limit results to [my chosen trustpass years range]. Keep the lower and upper bounds consistent and show only the matching records.
8. Find Matches By Wholesale Price
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Limit results to [my chosen wholesale price range]. Keep the lower and upper bounds consistent and show only the matching records.
9. Find Matches By Dropship Price
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Limit results to [my chosen dropship price range]. Keep the lower and upper bounds consistent and show only the matching records.
10. Find Matches By Order Count
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Limit results to [my chosen order count range]. Keep the lower and upper bounds consistent and show only the matching records.
11. Find Matches By Units Sold
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Limit results to [my chosen units sold range]. Keep the lower and upper bounds consistent and show only the matching records.
12. Find Matches By Sales Amount
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Limit results to [my chosen sales amount range]. Keep the lower and upper bounds consistent and show only the matching records.
13. Find Matches By Order Quantity
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Limit results to [my chosen order quantity range]. Keep the lower and upper bounds consistent and show only the matching records.
14. Find Matches By Listing Time
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Limit results to [my chosen listing time range]. Keep the lower and upper bounds consistent and show only the matching records.
15. Choose Exact Or Broader Keyword Matches
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Search for [my keyword] using [exact matching or broader matching], according to my research goal. Summarize only the returned records.
16. Find Offers With The Right Product Tags
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Narrow the search to [my selected product tags], such as the documented new-product or sourcing classifications. Summarize only the returned records.
17. Find Factories Or Trading Stores
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Focus on [factories, trading stores or either], according to my sourcing preference. Summarize only the returned records.
18. Choose A Supplier Membership
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Find offers from [my selected supplier membership groups]. Report only what the selected records support. For this selection, choose Super Factory, Power Seller or TrustPass member only.
19. Find Faster Dispatch
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Find offers that meet [my required dispatch time]. Report only what the selected records support. For this selection, choose 24 hours, 48 hours or 72 hours.
20. Find Dropshipping Services
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Find offers with [my required dropshipping services]. Report only what the selected records support. For this selection, choose one-piece dropship with free shipping or procure now, pay later.
21. Find Supplier Services
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Find offers with [my required supplier services]. Report only what the selected records support. For this selection, choose Safe Buy or Deep Verification Report.
22. Find Supplier Buyer Protections
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Find offers with [my required buyer protections]. Report only what the selected records support.
23. Find Compatible Shipping Labels
Prompt: Check 1688 Bestsellers for [search phrase translated into Simplified Chinese]. Find offers supporting [my required marketplace shipping-label service]. Report only what the selected records support. For this selection, choose Taobao, Douyin, Pinduoduo, Xiaohongshu or Kuaishou.
What You Need to Provide
Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.
Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.
Keyword requests require Simplified Chinese. Translate the search phrase before calling the tool; keep product IDs as strings.
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/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_1688_product_billboardhttps://api.nexscope.ai/mcptools/callInitialize 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 HTTPProgress 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
Find 1688 products in a specified weekly or monthly bestseller chart. Use product IDs 921378745459.
Example Answer
In the published sample, its reported asin is 921378745459. Its reported price is 27. Its reported sales quantity is 1095. These observations apply only to the shown record and reporting scope.
About this sample: Published documentation excerpt, not a live query. Arrays show at most two records and long text may be shortened. Missing units, dates or coverage remain unspecified; the excerpt does not represent the complete dataset.
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
Based on a published documentation sample, not a live tool call.
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": {
"productIds": "921378745459",
"pageType": 3,
"date": "2026-03-01"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "1688-product-billboard-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"products\":[{\"title\":\"头层牛皮针扣皮带男款 复古百搭牛仔裤带 简约休闲真皮腰带男士\",\"asin\":\"921378745459\",\"offerId\":\"921378745459\",\"price\":27,\"salesQuantity\":1095,\"salesOrderCount\":730,\"deliveryTime\":\"48\",\"quantityBegin\":1,\"availableDate\":\"2025-05-08 14:29:00\",\"levelName\":\"服饰配件、饰品>腰带/腰链/腰封>腰带\",\"shopUrl\":\"https://shop2950j93562603.1688.com\",\"asinUrl\":\"https://detail.1688.com/offer/921378745459.html\"}],\"total\":1}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"products": [
{
"title": "头层牛皮针扣皮带男款 复古百搭牛仔裤带 简约休闲真皮腰带男士",
"asin": "921378745459",
"offerId": "921378745459",
"price": 27,
"salesQuantity": 1095,
"salesOrderCount": 730,
"deliveryTime": "48",
"quantityBegin": 1,
"availableDate": "2025-05-08 14:29:00",
"levelName": "服饰配件、饰品>腰带/腰链/腰封>腰带",
"shopUrl": "https://shop2950j93562603.1688.com",
"asinUrl": "https://detail.1688.com/offer/921378745459.html"
}
],
"total": 1
}
},
"isError": false
}
}