1688 Sourcing

1688 Product Billboard

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.

post/api/skill-api/v1/skills/1688-product-billboard/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/1688-product-billboard/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

keyWordstring

Product search keyword (must be written in Simplified Chinese; translate it before calling this API). Maximum 50 characters

datestring

Query time. Weekly chart: pass the Sunday date of that week, e.g. 2025-06-15 (up to 90 days); Monthly chart: pass the first day of the month, e.g. 2025-06-01 (up to one year)

pageTypeinteger

Billboard type: 2 = weekly, 3 = monthly. Default 3

pageIndexinteger

Page number (starting from 1), default 1

pageSizeinteger

Number of results per page (10-100), default 20

sortFieldstring

Sort field, default orderCount. Options: orderCount (order count), saleCount (units sold), saleVolume (estimated sales amount), offerCreateTime (listing time), price (wholesale price), consignPrice (dropship price)

sortTypestring

Sort order: desc (descending), asc (ascending), default desc

searchTypeinteger

Product keyword search type: 1 = fuzzy match, 3 = exact match. Default 1

offerTypeinteger

Product tag: 0 = no limit, 2 = new product, 3 = 1688 Select, 4 = cross-border, 5 = customization supported, 6 = store highlight. Default 0

companyTypeinteger

Company type: 0 = no limit, 1 = store, 2 = factory

shiLiTypestring

Seller membership type (multi-select), comma-separated. Options: superFactory (Super Factory), Power (Power Seller), TrustPass (TrustPass member only)

beginTpYearinteger

Start TrustPass years

endTpYearinteger

End TrustPass years

beginPricenumber

Wholesale price (start)

endPricenumber

Wholesale price (end)

beginConsignPricenumber

Dropship price (start)

endConsignPricenumber

Dropship price (end)

beginOrderCountinteger

Order count (start)

endOrderCountinteger

Order count (end)

beginSaleCountinteger

Units sold (start)

endSaleCountinteger

Units sold (end)

beginSaleVolumenumber

Sales amount (start)

endSaleVolumenumber

Sales amount (end)

beginStartQuantityinteger

Minimum order quantity (start)

endStartQuantityinteger

Minimum order quantity (end)

beginOfferCreateTimestring

Listing time (start), format: YYYY-MM-DD

endOfferCreateTimestring

Listing time (end), format: YYYY-MM-DD

sendTimestring

Delivery time (multi-select), comma-separated. Options: 24 (24 hours), 48 (48 hours), 72 (72 hours)

proxyRightsstring

Dropship rights (multi-select), comma-separated. Options: 4360897 (one-piece dropship with free shipping), 449154 (procure now, pay later)

shopServicestring

Seller services (multi-select), comma-separated. Options: 4057409 (Safe Buy), 888777 (Deep Verification Report)

buyerProtectionsstring

Buyer protections, comma-separated: free shipping, 7-day free return, or shipping insurance

faceToFaceSupportstring

Waybill support (multi-select), comma-separated. Options: 441218 (Taobao), 386434 (Douyin), 422914 (Pinduoduo), 422978 (Xiaohongshu), 386370 (Kuaishou)

productIdsstring

Product IDs, separated by Chinese comma for multiple, max 20

goodsUrlstring

Product link URL

Example request

{
  "pageIndex": 1,
  "searchType": 1,
  "pageType": 3,
  "pageSize": 10,
  "date": "2026-07-01",
  "keyWord": "iPhone 15"
}

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Example response

{
  "data": {
    "total": 1,
    "products": []
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.