Skip to content

nexscope-ai/nexscope-ecommerce-skills / ecommerce-1688-product-billboard

ecommerce-1688-product-billboard

Verified

Query 1688 product bestseller billboard data for sourcing discovery and wholesale product research. Trigger when the user mentions 1688 product rankings, 1688 bestseller lists, wholesale hot products, domestic sourcing rankings, dropshipping product selection, 1688 trending products, bulk purchase popular items, supplier product rankings, 1688 billboard, 1688 bestsellers, sourcing rankings, wholesale hot products, trending product rankings, supplier rankings, 1688 trends. Even if the user does not explicitly mention "1688 billboard", if their need involves discovering hot-selling wholesale products or sourcing opportunities on the 1688 platform, this skill should also be triggered.

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

ParameterTypeRequiredDefaultDescription
keyWordstringNo—Product search keyword (must be in Chinese; translate first if not)
datestringNo—Query date. Weekly: Sunday date (e.g., 2025-06-15); Monthly: first of month (e.g., 2025-06-01)
pageTypeintegerNo3Billboard type: 2 = weekly, 3 = monthly
pageIndexintegerNo1Page number (starts from 1)
pageSizeintegerNo20Results per page (10-100)

Sorting

ParameterTypeDefaultDescription
sortFieldstringorderCountSort field: orderCount (orders), saleCount (units sold), saleVolume (est. revenue), offerCreateTime (listing date), price (wholesale price), consignPrice (dropship price)
sortTypestringdescSort order: desc (descending), asc (ascending)

Price & Volume Filters

ParameterTypeDescription
beginPrice / endPricenumberWholesale price range
beginConsignPrice / endConsignPricenumberDropship price range
beginOrderCount / endOrderCountintegerOrder count range
beginSaleCount / endSaleCountintegerUnits sold range
beginSaleVolume / endSaleVolumenumberEstimated revenue range
beginStartQuantity / endStartQuantityintegerMinimum order quantity range

Product & Seller Filters

ParameterTypeDescription
searchTypeintegerKeyword match mode: 1 = fuzzy (default), 3 = exact
offerTypeintegerProduct tag: 0 = any, 2 = new product, 3 = 1688 Select, 4 = cross-border, 5 = customizable, 6 = store treasure
companyTypeintegerCompany type: 0 = any, 1 = store, 2 = factory
shiLiTypestringSeller tier (comma-separated): superFactory, Power, TrustPass
beginTpYear / endTpYearintegerTrustPass membership years range

Logistics & Service Filters

ParameterTypeDescription
sendTimestringShipping time in hours (comma-separated): 24, 48, 72
proxyRightsstringDropship benefits (comma-separated): 4360897 (free shipping dropship), 449154 (buy-first-pay-later)
shopServicestringSeller services (comma-separated): 4057409 (worry-free purchase), 888777 (deep verification report)
buyerProtectionsstringBuyer protections (comma-separated values in Chinese)
faceToFaceSupportstringShipping label support (comma-separated): 441218 (Taobao), 386434 (Douyin), 422914 (Pinduoduo), 422978 (Xiaohongshu), 386370 (Kuaishou)

Other

ParameterTypeDescription
productIdsstringProduct IDs separated by the Chinese enumeration delimiter 、, max 20
goodsUrlstringDirect product URL for lookup
beginOfferCreateTime / endOfferCreateTimestringListing date range (format: YYYY-MM-DD)

Usage Examples

These are English intent examples for the Agent, before request preparation. Translate keyWord to Simplified Chinese and localized buyerProtections values to the provider's labels before invoking the script. Do not send the English terms below as raw upstream keyword values. Dates are illustrative; choose a date within the supported range at execution time.

1. Monthly bestsellers for a keyword

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

{"keyWord": "phone cases", "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": "yoga mats", "pageType": 2, "date": "2026-10-18", "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": "earphones", "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 light strips", "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": "pet supplies", "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": "handbags", "proxyRights": "4360897", "buyerProtections": "free shipping,7-day free returns", "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": "toys", "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

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

Authentication

Set the NEXSCOPE_API_KEY environment variable. For authentication and credits guidance, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS.

HTTP 401 means Nexscope authentication failed; HTTP 402 means insufficient credits. Invoking this Skill consumes credits. NEXSCOPE_PROXY_BASE defaults to https://api.nexscope.ai for the query script. Do not automatically repeat paid calls or substitute a buyer/store after marketplace authorization failure.

User-facing language

Use English for all user-facing explanations, examples, confirmations, results and error guidance. Translate provider-localized product titles, descriptions and business messages into English for presentation. Preserve identifiers, monetary values, units, URLs and original source data in saved artifacts. Keep official buyer, recipient, address and invoice details unchanged in API payloads; do not translate legal names or address records just to change their display language.

Before calling the script, translate an English keyWord into Simplified Chinese and map localized buyerProtections labels to their exact provider values. This is an Agent preparation step; the script does not translate and continues to validate the Chinese keyword contract. If a filter mapping is uncertain, explain it in English and omit the optional filter rather than inventing a provider value.

API Key request rate

All Nexscope API Keys belonging to the same user share one request-rate allowance for public API execution. The allowance is measured over any rolling 1-second window. Your RPS depends on your account entitlements; do not assume every user has a fixed 1 RPS. A single Skill operation may make multiple public API requests, and each request uses this allowance.

If an execution request returns HTTP 429 with outer code 13012, the request-rate allowance was exceeded. Honor the returned Retry-After before considering another request. Outer code 13013 means the concurrent-request limit was exceeded, not the rate limit; honor its Retry-After when supplied. Inspect the response and reconcile state before retrying. Never automatically replay a write operation or a request whose outcome is unclear.

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall