1688 Sourcing

1688 Product Search

Search and analyze products on the Chinese 1688 wholesale platform (Alibaba domestic B2B market) for sourcing, supplier discovery, and product selection. Trigger when the user mentions 1688 product search, finding suppliers on 1688, wholesale product queries, factory sourcing, dropshipping supplier search, 1688 keyword product selection, wholesale price comparison, filtering by sales volume, any product research on the 1688 platform, 1688 search, 1688 product selection, find suppliers, factory lookup, wholesale pricing, supplier search, domestic sourcing, 1688 products. Even if the user does not explicitly say "1688", if their need involves searching for wholesale products, finding domestic suppliers, or sourcing from the domestic Chinese market, this skill should also be triggered.

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

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/1688-product-search/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

Search keyword (must be written in Simplified Chinese; maximum 50 characters)

goodsUrlstring

Product link URL (mutually exclusive with keyWord)

productIdsstring

Product IDs, comma-separated, max 20

cyclestring

Statistical period: 7 (last 7 days) or 30 (last 30 days)

searchTypeinteger

Search type: 1 = fuzzy match, 3 = exact match

sortFieldstring

Sort field: orderCount7d, saleCount7d, saleVolume7d, orderCount30d, saleCount30d, saleVolume30d, offerCreateTime, price, consignPrice

sortTypestring

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

pageIndexinteger

Page number (starting from 1)

pageSizeinteger

Results per page (10-100)

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 purchase quantity (start)

endStartQuantityinteger

Minimum purchase quantity (end)

beginTpYearinteger

TrustPass years (start)

endTpYearinteger

TrustPass years (end)

beginOfferCreateTimestring

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

endOfferCreateTimestring

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

companyTypeinteger

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

offerTypeinteger

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

shiLiTypestring

Seller type (multi-select, comma-separated): superFactory (Super Factory), Power (Power Seller), TrustPass (TrustPass)

sendTimestring

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

faceToFaceSupportstring

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

proxyRightsstring

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

shopServicestring

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

buyerProtectionsstring

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

Example request

{
  "pageIndex": 1,
  "searchType": 1,
  "keyWord": "iPhone 15",
  "pageSize": 10
}

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.