Plugins

Scrape 1688.com wholesale search results

Searches 1688.com (China's B2B wholesale marketplace) for q and returns the offers as JSON: offerId, title, url, image/images, price in yuan (currency CNY), priceTiers (price per quantity range with minQuantity/maxQuantity), soldText + sold (lower bound of units sold), repurchaseRatePercent, serviceTags, promotionTags, tags, sponsored, and the supplier (name, loginId, memberId, shopUrl, yearsOnPlatform, province, city, factoryInspected, businessInspected, superFactory, tradeScores). Sort by relevance, sales or price, filter with price_min/price_max (yuan) and province, and collect up to max_results across pages (60 per page, each page billed as one request, see pagesFetched). Paging: nextPage is the next 1688 page not yet returned (pass it as page to continue) and hasMore says whether there is one; when max_results ends inside a page, the rest of that page is not returned (droppedFromLastPage), so use multiples of 60 to get every offer. Text is returned in Chinese as 1688 publishes it. Companion to /marketplace/1688-product.

post/marketplace/1688-search

Request

  • Base URL: https://api.scrapeunblocker.com
  • URL: https://api.scrapeunblocker.com/marketplace/1688-search
  • Auth: API key in header x-scrapeunblocker-key

Query parameters

qstring nullable

What to search, in Chinese or English, e.g. '手机壳', '连衣裙', 'bluetooth earphones'. Chinese keywords match the most offers.

pageinteger

1-based results page to start from (1-34). Use nextPage of a previous response to continue.

max_resultsinteger

Offers to collect across pages (1-300); 1688 serves 60 per page and each page fetched is billed as one request.

sortstring

Order: relevance, sales, price_asc, price_desc (sales = most sold in the last 30 days first; price in yuan).

price_minnumber nullable

Only offers priced at or above this many yuan (CNY).

price_maxnumber nullable

Only offers priced at or below this many yuan (CNY).

provincestring nullable

Only suppliers in this Chinese province, by its Chinese name, e.g. 广东 (Guangdong), 浙江 (Zhejiang), 江苏 (Jiangsu).

proxy_countrystring nullable

Proxy country the request is sent from (ISO-2, e.g. 'DE', 'SG'). Leave blank to let the API pick.

Response

JSON with a products array plus paging totals. A query 1688 has no offers for answers 200 with an empty array.

unknown required

Changes

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