1688 Sourcing: product Billboard API
nexscope_data_dl_product_billboard1688 Sourcing: product Billboard 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_billboard"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Weekly: Sunday within the last 90 days. Monthly: first day of a month within the last year. Omit for current default. | |
| 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 | |
| pageSize | No | Return quantity per page, range 10-100 | |
| pageType | No | List type: `2` weekly list, `3` monthly list | |
| sendTime | No | Shipping time, multiple selections separated by commas: `24`, `48`, `72` hours | |
| sortType | No | Sorting type: `desc` descending order, `asc` ascending order | desc |
| endTpYear | No | End of integrity pass period | |
| offerType | No | Product identification: `0` is not limited, `2` is new, `3` is carefully selected by 1688, `4` is cross-border, `5` supports customization, `6` is the treasure of the store | |
| pageIndex | No | Page number, starting from 1 | |
| shiLiType | No | Seller membership type, separate multiple choices with commas: `superFactory` super factory, `Power` powerful merchant, `TrustPass` integrity member | |
| sortField | No | `orderCount` sales number, `saleCount` sales number, `saleVolume` estimated sales, `offerCreateTime` shelf time, `price` wholesale price, `consignPrice` consignment price | orderCount |
| beginPrice | No | Wholesale price starting value | |
| productIds | No | Up to 20 product IDs separated by Chinese enumeration commas (、). | |
| searchType | No | Product keyword search: `1` fuzzy matching, `3` precise matching | |
| beginTpYear | No | Start the Integrity 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 | end batch | |
| 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 batch size | |
| endOfferCreateTime | No | Shelf time end value, format `YYYY-MM-DD` | |
| beginOfferCreateTime | No | Starting value of shelf time, format `YYYY-MM-DD` |