1688 Sourcing: product Search API
nexscope_data_dl_product_search1688 Sourcing: product Search API. Chinese keywords are required when provided. Product IDs remain strings. Prices and sales estimates follow the requested statistical period.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "nexscope_data_dl_product_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cycle | No | Statistical period: `7` last 7 days or `30` last 30 days | |
| keyWord | No | Chinese search keyword, at most 50 characters. Translate your search terms to Chinese before sending. | |
| endPrice | No | wholesale price ending value | |
| goodsUrl | No | Product link address, choose one from `keyWord` | |
| pageSize | No | Quantity per page, range 10-100 | |
| sendTime | No | Shipping time, multiple selections separated by commas: `24`, `48`, `72` | |
| sortType | No | Sorting type: `desc` descending order, `asc` ascending order | desc |
| endTpYear | No | Integrity Pass life end value | |
| offerType | No | Product identification: `0` is not limited, `2` is new, `3` is 1688 carefully selected, `4` is cross-border, `5` supports customization, `6` is the treasure of the store | |
| pageIndex | No | Page number, starting from 1 | |
| shiLiType | No | Seller type, multiple selections separated by commas: `superFactory`, `Power`, `TrustPass` | |
| sortField | No | `orderCount7d`、`saleCount7d`、`saleVolume7d`、`orderCount30d`、`saleCount30d`、`saleVolume30d`、`offerCreateTime`、`price`、`consignPrice` | orderCount30d |
| beginPrice | No | Wholesale price starting value | |
| productIds | No | Up to 20 product IDs separated by commas (,). | |
| searchType | No | Search type: `1` fuzzy matching, `3` precise matching | |
| beginTpYear | No | Starting value of the credit pass period | |
| companyType | No | Company type: `0` unlimited, `1` shop, `2` factory | |
| proxyRights | No | For drop-shipping rights, multiple options must be separated by commas: `4360897`, free shipping for one piece, `449154`, purchase first, pay later | |
| shopService | No | Seller services, multiple selections separated by commas: `4057409` Safe Purchase, `888777` In-depth Certification Report | |
| endSaleCount | No | Sales end value | |
| endOrderCount | No | Sales end value | |
| endSaleVolume | No | sales end value | |
| beginSaleCount | No | Starting value of sales units | |
| beginOrderCount | No | Starting value of number of sales | |
| beginSaleVolume | No | sales starting value | |
| endConsignPrice | No | The end value of the agency price | |
| buyerProtections | No | Rights protection, separate multiple choices with commas: `Free shipping for goods`, `7-day return guarantee`, `Support freight insurance` | |
| endStartQuantity | No | Minimum purchase quantity end value | |
| beginConsignPrice | No | Starting value of agency price | |
| faceToFaceSupport | No | Farewell support, multiple selections separated by commas: `441218` Taobao, `386434` Douyin, `422914` Pinduoduo, `422978` Xiaohongshu, `386370` Kuaishou | |
| beginStartQuantity | No | Starting value of minimum purchase quantity | |
| endOfferCreateTime | No | Shelf time end value, format `YYYY-MM-DD` | |
| beginOfferCreateTime | No | Starting value of shelf time, format `YYYY-MM-DD` |