• 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.

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

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

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

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

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

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

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

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

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

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

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

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

"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"}

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

{"productIds": "123456、789012"}

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)

• 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.

• 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

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

references/api.md