1688-商品热销榜单-x-7

原始内容

---
name: linkfox-dld-product-billboard
description: 查询1688商品热销榜单数据，用于货源发现和批发选品调研。当用户提到1688商品排行、1688热销榜、批发爆款商品、国内货源榜单、一件代发选品、1688趋势商品、批量采购热门品、供应商商品排名、1688 billboard, 1688 bestsellers, sourcing rankings, wholesale hot products, trending product rankings, supplier rankings, 1688 trends时触发此技能。即使用户未明确提及"1688榜单"，只要其需求涉及发现1688平台上的热销批发商品或货源机会，也应触发此技能。
---

# DLD Product Billboard (1688 Bestseller Rankings)

This skill guides you on how to query 1688 platform product bestseller billboard data, helping sellers discover hot-selling wholesale products and sourcing opportunities on China's largest B2B marketplace.

## Core Concepts

The DLD Product Billboard provides access to 1688 platform's product ranking data, covering both **weekly** and **monthly** bestseller lists. It enables users to discover trending wholesale products, compare suppliers, and identify sourcing opportunities in the domestic Chinese wholesale market.

**Billboard types**:
- **Weekly Billboard** (`pageType=2`): Date parameter should be the Sunday of the target week (e.g., `2025-06-15`). Data available for the last 90 days.
- **Monthly Billboard** (`pageType=3`): Date parameter should be the first day of the target month (e.g., `2025-06-01`). Data available for the last 12 months.

**Default behavior**: Monthly billboard, sorted by order count descending, 20 results per page.

## Parameter Guide

### Core Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| keyWord | string | No | — | Product search keyword (must be in Chinese; translate first if not) |
| date | string | No | — | Query date. Weekly: Sunday date (e.g., `2025-06-15`); Monthly: first of month (e.g., `2025-06-01`) |
| pageType | integer | No | 3 | Billboard type: `2` = weekly, `3` = monthly |
| pageIndex | integer | No | 1 | Page number (starts from 1) |
| pageSize | integer | No | 20 | Results per page (10-100) |

### Sorting

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| sortField | string | `orderCount` | Sort field: `orderCount` (orders), `saleCount` (units sold), `saleVolume` (est. revenue), `offerCreateTime` (listing date), `price` (wholesale price), `consignPrice` (dropship price) |
| sortType | string | `desc` | Sort order: `desc` (descending), `asc` (ascending) |

### Price & Volume Filters

| Parameter | Type | Description |
|-----------|------|-------------|
| beginPrice / endPrice | number | Wholesale price range |
| beginConsignPrice / endConsignPrice | number | Dropship price range |
| beginOrderCount / endOrderCount | integer | Order count range |
| beginSaleCount / endSaleCount | integer | Units sold range |
| beginSaleVolume / endSaleVolume | number | Estimated revenue range |
| beginStartQuantity / endStartQuantity | integer | Minimum order quantity range |

### Product & Seller Filters

| Parameter | Type | Description |
|-----------|------|-------------|
| searchType | integer | Keyword match mode: `1` = fuzzy (default), `3` = exact |
| offerType | integer | Product tag: `0` = any, `2` = new product, `3` = 1688 Select, `4` = cross-border, `5` = customizable, `6` = store treasure |
| companyType | integer | Company type: `0` = any, `1` = store, `2` = factory |
| shiLiType | string | Seller tier (comma-separated): `superFactory`, `Power`, `TrustPass` |
| beginTpYear / endTpYear | integer | TrustPass membership years range |

### Logistics & Service Filters

| Parameter | Type | Description |
|-----------|------|-------------|
| sendTime | string | Shipping time in hours (comma-separated): `24`, `48`, `72` |
| proxyRights | string | Dropship benefits (comma-separated): `4360897` (free shipping dropship), `449154` (buy-first-pay-later) |
| shopService | string | Seller services (comma-separated): `4057409` (worry-free purchase), `888777` (deep verification report) |
| buyerProtections | string | Buyer protections (comma-separated values in Chinese) |
| faceToFaceSupport | string | Shipping label support (comma-separated): `441218` (Taobao), `386434` (Douyin), `422914` (Pinduoduo), `422978` (Xiaohongshu), `386370` (Kuaishou) |

### Other

| Parameter | Type | Description |
|-----------|------|-------------|
| productIds | string | Product IDs separated by Chinese comma, max 20 |
| goodsUrl | string | Direct product URL for lookup |
| beginOfferCreateTime / endOfferCreateTime | string | Listing date range (format: `YYYY-MM-DD`) |

## Usage Examples

**1. Monthly bestsellers for a keyword**
> "Show me the top-selling phone cases on 1688 this month"
```json
{"keyWord": "手机壳", "pageType": 3, "date": "2026-03-01", "sortField": "orderCount", "sortType": "desc"}
```

**2. Weekly billboard sorted by revenue**
> "What products had the highest revenue last week in the yoga mat category?"
```json
{"keyWord": "瑜伽垫", "pageType": 2, "date": "2026-03-22", "sortField": "saleVolume", "sortType": "desc"}
```

**3. Factory-direct products with price filter**
> "Find factory-direct earphone products on 1688 priced between 5 and 30 yuan"
```json
{"keyWord": "耳机", "companyType": 2, "beginPrice": 5, "endPrice": 30, "sortField": "saleCount", "sortType": "desc"}
```

**4. Cross-border tagged products with fast shipping**
> "Show cross-border tagged LED light products that ship within 24 hours"
```json
{"keyWord": "LED灯", "offerType": 4, "sendTime": "24", "sortField": "orderCount", "sortType": "desc"}
```

**5. New products from super factories**
> "Find newly listed products from super factories in the pet supplies category"
```json
{"keyWord": "宠物用品", "offerType": 2, "shiLiType": "superFactory", "sortField": "offerCreateTime", "sortType": "desc"}
```

**6. Dropship-friendly products with buyer protections**
> "Show me dropship-friendly bag products with free shipping and return support"
```json
{"keyWord": "包包", "proxyRights": "4360897", "buyerProtections": "商品包邮,7天包退货", "sortField": "orderCount", "sortType": "desc"}
```

**7. High-volume products in a price range**
> "Find products with more than 1000 orders and wholesale price under 50 yuan in the toy category"
```json
{"keyWord": "玩具", "beginOrderCount": 1000, "endPrice": 50, "sortField": "orderCount", "sortType": "desc"}
```

**8. Browse by product IDs**
> "Look up these specific 1688 product IDs: 123456、789012"
```json
{"productIds": "123456、789012"}
```

## Display Rules

1. **Present data clearly**: Show product results in well-organized tables including product title, wholesale price, dropship price, order count, units sold, estimated revenue, supplier name, and listing date
2. **Image display**: When `imageUrl` is available, display product images to help users visually identify products
3. **Link provision**: Include product links (`asinUrl`) and shop links (`shopUrl`) so users can navigate directly to the 1688 listing
4. **Price formatting**: Always show prices with the currency (CNY/RMB) and clarify whether the price is wholesale or dropship
5. **Volume context**: When presenting sales data, clearly label whether it is weekly or monthly data based on the `dataType` field
6. **Pagination guidance**: When total results exceed the current page, inform the user of the total count and offer to fetch more pages
7. **Keyword translation**: If the user provides a keyword in a non-Chinese language, translate it to Chinese before querying, and inform the user of the translated keyword
8. **Error handling**: When a query fails, explain the issue and suggest adjusting parameters (e.g., broadening filters, checking date format)
## Important Limitations

- **Keyword language**: The `keyWord` parameter must be in Chinese. Always translate non-Chinese keywords before querying.
- **Date format matters**: Weekly billboard dates must be a Sunday; monthly billboard dates must be the 1st of the month.
- **Weekly data range**: Last 90 days only.
- **Monthly data range**: Last 12 months only.
- **Page size cap**: Maximum 100 results per request.
- **Product ID limit**: Maximum 20 product IDs per lookup.

## User Expression & Scenario Quick Reference

**Applicable** -- 1688 wholesale product discovery and sourcing:

| User Says | Scenario |
|-----------|----------|
| "What's hot on 1688", "1688 trending products" | Bestseller discovery |
| "Find cheap suppliers for XX", "wholesale source for XX" | Sourcing by keyword |
| "Factory-direct products", "OEM suppliers" | Factory filtering |
| "Cross-border sourcing", "products for export" | Cross-border tag filtering |
| "Dropshipping products on 1688" | Dropship-enabled product search |
| "New products on 1688", "recently listed items" | New product discovery |
| "Compare suppliers for XX" | Multi-result comparison |
| "1688 product ranking", "bestseller list" | Billboard browsing |

**Not applicable** -- Needs beyond 1688 product billboard data:
- Amazon product research or keyword analysis (use ABA tools instead)
- 1688 store/shop-level analytics (shop rankings, shop scores)
- Alibaba.com (international) data
- Price negotiation or order placement
- Product quality reviews or certifications
- Logistics cost calculation or freight forwarding


## 解决认证和积分问题
发生以下异常情况时，采用以下措施来处理：

### 异常情况
- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。
- **响应401或402状态码**
- **响应提示积分或余额不足**：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

### 措施
- 优先采用skill内的 onboarding.md 引导解决问题。
- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：
    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。如需用户授权才可下载，要询问用户获得授权，你不能自己放弃下载。
- 兜底措施：仅当前面两个措施经过所有努力都走不通时，才提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 指引获取API Key，或去 https://os.linkfox.com/ 补充积分。

## 积分消耗规则

消耗 9 积分。

> 用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

**Feedback:**

Auto-detect and report feedback via the Feedback API when any of the following apply:
1. The functionality or purpose described in this skill does not match actual behavior
2. The skill's results do not match the user's intent
3. The user expresses dissatisfaction or praise about this skill
4. Anything you believe could be improved

Call the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.

---
*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*

name: linkfox-dld-product-billboard description: 查询1688商品热销榜单数据，用于货源发现和批发选品调研。当用户提到1688商品排行、1688热销榜、批发爆款商品、国内货源榜单、一件代发选品、1688趋势商品、批量采购热门品、供应商商品排名、1688 billboard, 1688 bestsellers, sourcing rankings, wholesale hot products, trending product rankings, supplier rankings, 1688 trends时触发此技能。即使用户未明确提及"1688榜单"，只要其需求涉及发现1688平台上的热销批发商品或货源机会，也应触发此技能。

DLD Product Billboard (1688 Bestseller Rankings)

This skill guides you on how to query 1688 platform product bestseller billboard data, helping sellers discover hot-selling wholesale products and sourcing opportunities on China's largest B2B marketplace.

Core Concepts

The DLD Product Billboard provides access to 1688 platform's product ranking data, covering both weekly and monthly bestseller lists. It enables users to discover trending wholesale products, compare suppliers, and identify sourcing opportunities in the domestic Chinese wholesale market.

Billboard types:

Weekly Billboard (pageType=2): Date parameter should be the Sunday of the target week (e.g., 2025-06-15). Data available for the last 90 days.
Monthly Billboard (pageType=3): Date parameter should be the first day of the target month (e.g., 2025-06-01). Data available for the last 12 months.

Default behavior: Monthly billboard, sorted by order count descending, 20 results per page.

Parameter Guide

Core Parameters

Parameter	Type	Required	Default	Description
keyWord	string	No	—	Product search keyword (must be in Chinese; translate first if not)
date	string	No	—	Query date. Weekly: Sunday date (e.g., `2025-06-15`); Monthly: first of month (e.g., `2025-06-01`)
pageType	integer	No	3	Billboard type: `2` = weekly, `3` = monthly
pageIndex	integer	No	1	Page number (starts from 1)
pageSize	integer	No	20	Results per page (10-100)

Sorting

Parameter	Type	Default	Description
sortField	string	`orderCount`	Sort field: `orderCount` (orders), `saleCount` (units sold), `saleVolume` (est. revenue), `offerCreateTime` (listing date), `price` (wholesale price), `consignPrice` (dropship price)
sortType	string	`desc`	Sort order: `desc` (descending), `asc` (ascending)

Price & Volume Filters

Parameter	Type	Description
beginPrice / endPrice	number	Wholesale price range
beginConsignPrice / endConsignPrice	number	Dropship price range
beginOrderCount / endOrderCount	integer	Order count range
beginSaleCount / endSaleCount	integer	Units sold range
beginSaleVolume / endSaleVolume	number	Estimated revenue range
beginStartQuantity / endStartQuantity	integer	Minimum order quantity range

Product & Seller Filters

Parameter	Type	Description
searchType	integer	Keyword match mode: `1` = fuzzy (default), `3` = exact
offerType	integer	Product tag: `0` = any, `2` = new product, `3` = 1688 Select, `4` = cross-border, `5` = customizable, `6` = store treasure
companyType	integer	Company type: `0` = any, `1` = store, `2` = factory
shiLiType	string	Seller tier (comma-separated): `superFactory`, `Power`, `TrustPass`
beginTpYear / endTpYear	integer	TrustPass membership years range

Logistics & Service Filters

Parameter	Type	Description
sendTime	string	Shipping time in hours (comma-separated): `24`, `48`, `72`
proxyRights	string	Dropship benefits (comma-separated): `4360897` (free shipping dropship), `449154` (buy-first-pay-later)
shopService	string	Seller services (comma-separated): `4057409` (worry-free purchase), `888777` (deep verification report)
buyerProtections	string	Buyer protections (comma-separated values in Chinese)
faceToFaceSupport	string	Shipping label support (comma-separated): `441218` (Taobao), `386434` (Douyin), `422914` (Pinduoduo), `422978` (Xiaohongshu), `386370` (Kuaishou)

Other

Parameter	Type	Description
productIds	string	Product IDs separated by Chinese comma, max 20
goodsUrl	string	Direct product URL for lookup
beginOfferCreateTime / endOfferCreateTime	string	Listing date range (format: `YYYY-MM-DD`)

Usage Examples

1. Monthly bestsellers for a keyword

"Show me the top-selling phone cases on 1688 this month"

{"keyWord": "手机壳", "pageType": 3, "date": "2026-03-01", "sortField": "orderCount", "sortType": "desc"}

2. Weekly billboard sorted by revenue

"What products had the highest revenue last week in the yoga mat category?"

{"keyWord": "瑜伽垫", "pageType": 2, "date": "2026-03-22", "sortField": "saleVolume", "sortType": "desc"}

3. Factory-direct products with price filter

"Find factory-direct earphone products on 1688 priced between 5 and 30 yuan"

{"keyWord": "耳机", "companyType": 2, "beginPrice": 5, "endPrice": 30, "sortField": "saleCount", "sortType": "desc"}

4. Cross-border tagged products with fast shipping

"Show cross-border tagged LED light products that ship within 24 hours"

{"keyWord": "LED灯", "offerType": 4, "sendTime": "24", "sortField": "orderCount", "sortType": "desc"}

5. New products from super factories

"Find newly listed products from super factories in the pet supplies category"

{"keyWord": "宠物用品", "offerType": 2, "shiLiType": "superFactory", "sortField": "offerCreateTime", "sortType": "desc"}

6. Dropship-friendly products with buyer protections

"Show me dropship-friendly bag products with free shipping and return support"

{"keyWord": "包包", "proxyRights": "4360897", "buyerProtections": "商品包邮,7天包退货", "sortField": "orderCount", "sortType": "desc"}

7. High-volume products in a price range

"Find products with more than 1000 orders and wholesale price under 50 yuan in the toy category"

{"keyWord": "玩具", "beginOrderCount": 1000, "endPrice": 50, "sortField": "orderCount", "sortType": "desc"}

8. Browse by product IDs

"Look up these specific 1688 product IDs: 123456、789012"

{"productIds": "123456、789012"}

Display Rules

Present data clearly: Show product results in well-organized tables including product title, wholesale price, dropship price, order count, units sold, estimated revenue, supplier name, and listing date
Image display: When imageUrl is available, display product images to help users visually identify products
Link provision: Include product links (asinUrl) and shop links (shopUrl) so users can navigate directly to the 1688 listing
Price formatting: Always show prices with the currency (CNY/RMB) and clarify whether the price is wholesale or dropship
Volume context: When presenting sales data, clearly label whether it is weekly or monthly data based on the dataType field
Pagination guidance: When total results exceed the current page, inform the user of the total count and offer to fetch more pages
Keyword translation: If the user provides a keyword in a non-Chinese language, translate it to Chinese before querying, and inform the user of the translated keyword
Error handling: When a query fails, explain the issue and suggest adjusting parameters (e.g., broadening filters, checking date format)

Important Limitations

Keyword language: The keyWord parameter must be in Chinese. Always translate non-Chinese keywords before querying.
Date format matters: Weekly billboard dates must be a Sunday; monthly billboard dates must be the 1st of the month.
Weekly data range: Last 90 days only.
Monthly data range: Last 12 months only.
Page size cap: Maximum 100 results per request.
Product ID limit: Maximum 20 product IDs per lookup.

User Expression & Scenario Quick Reference

Applicable -- 1688 wholesale product discovery and sourcing:

User Says	Scenario
"What's hot on 1688", "1688 trending products"	Bestseller discovery
"Find cheap suppliers for XX", "wholesale source for XX"	Sourcing by keyword
"Factory-direct products", "OEM suppliers"	Factory filtering
"Cross-border sourcing", "products for export"	Cross-border tag filtering
"Dropshipping products on 1688"	Dropship-enabled product search
"New products on 1688", "recently listed items"	New product discovery
"Compare suppliers for XX"	Multi-result comparison
"1688 product ranking", "bestseller list"	Billboard browsing

Not applicable -- Needs beyond 1688 product billboard data:

Amazon product research or keyword analysis (use ABA tools instead)
1688 store/shop-level analytics (shop rankings, shop scores)
Alibaba.com (international) data
Price negotiation or order placement
Product quality reviews or certifications
Logistics cost calculation or freight forwarding

解决认证和积分问题

发生以下异常情况时，采用以下措施来处理：

异常情况

未配置API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
响应401或402状态码
响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

措施

优先采用skill内的 onboarding.md 引导解决问题。
如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：
- 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。如需用户授权才可下载，要询问用户获得授权，你不能自己放弃下载。
兜底措施：仅当前面两个措施经过所有努力都走不通时，才提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 指引获取API Key，或去 https://os.linkfox.com/ 补充积分。

积分消耗规则

消耗 9 积分。

用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
Anything you believe could be improved

Call the feedback API as specified in references/api.md. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.