1688 Sourcing

1688 Product Search MCP

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

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

1688 Product Search 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. Search 1688 Wholesale Products For A Sourcing Brief

Prompt: Search 1688 wholesale products for a sourcing brief for [search phrase translated into Simplified Chinese]. Show the available results and clearly identify missing information.

2. Search 1688 Wholesale Products For A Sourcing Brief By Product IDs

Prompt: Search 1688 wholesale products for a sourcing brief using [product IDs]. Keep the returned results tied to that input and do not infer matches that were not returned.

3. Search 1688 Wholesale Products For A Sourcing Brief By Product Link

Prompt: Search 1688 wholesale products for a sourcing brief 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: Search 1688 wholesale products for a sourcing brief 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: Search 1688 wholesale products for a sourcing brief 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: Search 1688 wholesale products for a sourcing brief 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 7-day order count, 7-day units sold, 7-day sales amount, 30-day order count, 30-day units sold, 30-day sales amount, listing date, wholesale price or dropship price.

7. Find Matches By Wholesale Price

Prompt: Search 1688 wholesale products for a sourcing brief 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.

8. Find Matches By Dropship Price

Prompt: Search 1688 wholesale products for a sourcing brief 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.

9. Find Matches By Order Count

Prompt: Search 1688 wholesale products for a sourcing brief 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.

10. Find Matches By Units Sold

Prompt: Search 1688 wholesale products for a sourcing brief 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.

11. Find Matches By Sales Amount

Prompt: Search 1688 wholesale products for a sourcing brief 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.

12. Find Matches By Purchase Quantity

Prompt: Search 1688 wholesale products for a sourcing brief for [search phrase translated into Simplified Chinese]. Limit results to [my chosen purchase quantity range]. Keep the lower and upper bounds consistent and show only the matching records.

13. Find Matches By Trustpass Years

Prompt: Search 1688 wholesale products for a sourcing brief 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.

14. Find Matches By Listing Date

Prompt: Search 1688 wholesale products for a sourcing brief for [search phrase translated into Simplified Chinese]. Limit results to [my chosen listing date range]. Keep the lower and upper bounds consistent and show only the matching records.

15. Choose Exact Or Broader Keyword Matches

Prompt: Search 1688 wholesale products for a sourcing brief 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 Factories Or Trading Stores

Prompt: Search 1688 wholesale products for a sourcing brief for [search phrase translated into Simplified Chinese]. Focus on [factories, trading stores or either], according to my sourcing preference. Summarize only the returned records.

17. Find Offers With The Right Product Tags

Prompt: Search 1688 wholesale products for a sourcing brief 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.

18. Choose A Supplier Membership

Prompt: Search 1688 wholesale products for a sourcing brief for [search phrase translated into Simplified Chinese]. Find offers from [my selected supplier membership groups]. Report only what the selected records support.

19. Find Faster Dispatch

Prompt: Search 1688 wholesale products for a sourcing brief for [search phrase translated into Simplified Chinese]. Find offers that meet [my required dispatch time]. Report only what the selected records support.

20. Find Compatible Shipping Labels

Prompt: Search 1688 wholesale products for a sourcing brief for [search phrase translated into Simplified Chinese]. Find offers supporting [my required marketplace shipping-label service]. Report only what the selected records support.

21. Find Dropshipping Services

Prompt: Search 1688 wholesale products for a sourcing brief for [search phrase translated into Simplified Chinese]. Find offers with [my required dropshipping services]. Report only what the selected records support.

22. Find Supplier Services

Prompt: Search 1688 wholesale products for a sourcing brief for [search phrase translated into Simplified Chinese]. Find offers with [my required supplier services]. Report only what the selected records support.

23. Find Supplier Buyer Protections

Prompt: Search 1688 wholesale products for a sourcing brief for [search phrase translated into Simplified Chinese]. Find offers with [my required buyer protections]. Report only what the selected records support.

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/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_search

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-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
`cycle`	`string`	optional	Statistical period: 7 (last 7 days) or 30 (last 30 days)
`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)
`endOfferCreateTime`	`string`	optional	Listing time end (format: YYYY-MM-DD)
`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)
`sendTime`	`string`	optional	Delivery time (multi-select, comma-separated): 24, 48, 72
`faceToFaceSupport`	`string`	optional	Waybill support (multi-select, comma-separated): 441218 (Taobao), 386434 (Douyin), 422914 (Pinduoduo), 422978 (Xiaohongshu), 386370 (Kuaishou)
`proxyRights`	`string`	optional	Dropship rights (multi-select, comma-separated): 4360897 (one-piece dropship with free shipping), 449154 (procure now, pay later)
`shopService`	`string`	optional	Seller services (multi-select, comma-separated): 4057409 (Safe Buy), 888777 (Deep Verification Report)
`buyerProtections`	`string`	optional	Buyer protections, comma-separated: free shipping, 7-day free return, or shipping insurance

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
`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, returned according to statistical period
`data.products[].imageUrl`	`string`	optional	Product picture 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	Number of sales, returned according to statistical period
`data.products[].salesQuantity`	`integer`	optional	Number of pieces sold, returned according to 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	Total 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

Search 1688 wholesale products for a sourcing brief. Use “MLG0402P6N8HT000”.

Example Answer

In the published sample, its reported asin is 1050125350953. Its reported price is 0.02. Its reported sales quantity is 0. 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

{
  "pageIndex": 1,
  "searchType": 1,
  "keyWord": "MLG0402P6N8HT000",
  "pageSize": 10
}

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 4,
    "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": 0,
        "deliveryTime": "48",
        "quantityBegin": 100,
        "availableDate": "2026-05-12 14:44:00",
        "levelName": "电子元器件>无源元件>电感器",
        "title": "全新有货MLG0402P6N8HT000 MLG0402P6N8JT000 01005高频叠层电感",
        "shopUrl": "https://shenzhenlitao.1688.com",
        "asinUrl": "https://detail.1688.com/offer/1050125350953.html",
        "estimatedSalesAmount": 0,
        "consignPrice": 0.06,
        "unit": "PCS",
        "sourceTool": "店雷达-1688选品库",
        "sourceType": "1688",
        "price": 0.02,
        "salesQuantity": 0,
        "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN012TNHJR2NBi5igSTW7_!!2208464149925-0-cib.jpg",
        "offerId": "1050125350953",
        "asin": "1050125350953",
        "company": "深圳市立淘电子有限公司",
        "currency": "¥",
        "shopId": "b2b-220846414992543287",
        "quantityPrices": "[{\"quantity\":\"100~19999\",\"value\":\"0.06\"},{\"quantity\":\"20000~599999\",\"value\":\"0.03\"},{\"quantity\":\"≥600000\",\"value\":\"0.02\"}]"
      },
      {
        "salesOrderCount": 0,
        "deliveryTime": "",
        "quantityBegin": 100,
        "availableDate": "2026-03-18 16:21:00",
        "levelName": "电子元器件>无源元件>电感器",
        "title": "全新有货MLG0402P6N8HT000 MLG0402P6N8JT000 01005高频叠层电感",
        "shopUrl": "https://gxhydz.1688.com",
        "asinUrl": "https://detail.1688.com/offer/1031776403463.html",
        "estimatedSalesAmount": 0,
        "consignPrice": 0.06,
        "unit": "PCS",
        "sourceTool": "店雷达-1688选品库",
        "sourceType": "1688",
        "price": 0.02,
        "salesQuantity": 0,
        "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01fUlWJP1zAHpRu9dLy_!!3371546673-0-cib.jpg",
        "offerId": "1031776403463",
        "asin": "1031776403463",
        "company": "深圳市福田区广兴洪业电子商行",
        "currency": "¥",
        "shopId": "b2b-337154667312c12",
        "quantityPrices": "[{\"quantity\":\"100~19999\",\"value\":\"0.06\"},{\"quantity\":\"20000~599999\",\"value\":\"0.03\"},{\"quantity\":\"≥600000\",\"value\":\"0.02\"}]"
      },
      {
        "salesOrderCount": 0,
        "deliveryTime": "48",
        "quantityBegin": 100,
        "availableDate": "2026-05-13 16:03:00",
        "levelName": "电子元器件>无源元件>电感器",
        "title": "全新有货MLG0402P6N8HT000 MLG0402P6N8JT000 01005高频叠层电感",
        "shopUrl": "https://shenzhenxunlehui.1688.com",
        "asinUrl": "https://detail.1688.com/offer/1050432166385.html",
        "estimatedSalesAmount": 0,
        "consignPrice": 0.06,
        "unit": "PCS",
        "sourceTool": "店雷达-1688选品库",
        "sourceType": "1688",
        "price": 0.02,
        "salesQuantity": 0,
        "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01xOIh2BeCUQD1chua_!!2208104166199-0-cib.jpg",
        "offerId": "1050432166385",
        "asin": "1050432166385",
        "company": "深圳市讯乐汇电子有限公司",
        "currency": "¥",
        "shopId": "b2b-2208104166199ede2f",
        "quantityPrices": "[{\"quantity\":\"100~19999\",\"value\":\"0.06\"},{\"quantity\":\"20000~599999\",\"value\":\"0.03\"},{\"quantity\":\"≥600000\",\"value\":\"0.02\"}]"
      },
      {
        "salesOrderCount": 0,
        "deliveryTime": "48",
        "quantityBegin": 10,
        "availableDate": "2025-10-30 15:11:00",
        "levelName": "电子元器件>无源元件>电感器",
        "title": "6.8nH ±3%\tMLG0402P6N8HT000\t01005\t贴片电感",
        "shopUrl": "https://shop3r04r872946r4.1688.com",
        "asinUrl": "https://detail.1688.com/offer/990602269036.html",
        "estimatedSalesAmount": 0,
        "consignPrice": 0.2,
        "unit": "PCS",
        "sourceTool": "店雷达-1688选品库",
        "sourceType": "1688",
        "price": 0.2,
        "salesQuantity": 0,
        "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01adDAty1iK30LXYb6B_!!2220636464393-0-cib.jpg",
        "offerId": "990602269036",
        "asin": "990602269036",
        "company": "斯塔克波尔（深圳）科技有限公司",
        "currency": "¥",
        "shopId": "b2b-222063646439383a79",
        "quantityPrices": "[{\"quantity\":\"≥10\",\"value\":\"0.20\"}]"
      }
    ]
  }
}

View the MCP Request & Response Format

Examples