1688 Search Scraper

Search 1688.com, China's largest B2B wholesale marketplace (Alibaba's domestic site), and get every offer as clean JSON: title, URL, images, yuan price with the quantity price ladder, units sold, repurchase rate, service and promotion tags, the sponsored flag and the supplier (company, shop URL, years on 1688, province and city, factory and business inspection, Super Factory, trade-service scores). Many queries per run, sorting and price / province filters. Text comes in Chinese as 1688 publishes it. No 1688 account, no proxies to configure.

Features

• Any search - Chinese keywords match the most offers (手机壳, 连衣裙, 蓝牙耳机), English works too.
• Up to 2040 offers per query - all 34 result pages of 60 offers, paged automatically.
• Wholesale pricing - the price per quantity range (priceTiers with min / max quantity).
• Demand signals - units sold and the supplier's repurchase rate.
• Supplier vetting - years on 1688, location, factory / business inspection, Super Factory, trade scores (consultation, logistics, disputes, returns, goods).
• Sort and filter - best match, most sold, price up / down; yuan price range; supplier province.

Need the full offer page (SKU matrix with per-SKU stock and price, attributes, MOQ, shipping, rating summary)? Use our 1688 Product Scraper with the offer URLs from this actor.

Use cases

• Product sourcing - find suppliers and wholesale prices for a product idea.
• Price research - compare quantity price ladders across hundreds of suppliers.
• Dropshipping and Amazon FBA - spot best sellers and their factory prices.
• Supplier shortlisting - filter by province and inspection status, rank by trade scores.

Input

Field	Type	Default	Description
queries	array	手机壳	1688 searches, one per line.
maxResults	integer	60	Offers per query (1-2040).
sort	string	relevance	relevance, sales, price_asc or price_desc.
minPrice / maxPrice	string	-	Price range in yuan, e.g. 5 / 30.
province	string	-	Supplier province in Chinese, e.g. 广东, 浙江.
proxyCountry	string	-	Optional exit-IP country (ISO-2).
concurrency	integer	3	Queries searched at the same time (1-5).

Example input

{
  "queries": ["连衣裙", "蓝牙耳机"],
  "maxResults": 120,
  "sort": "sales",
  "minPrice": "20",
  "maxPrice": "80",
  "province": "广东"
}

Output

One dataset item per offer:

{
  "query": "手机壳",
  "position": 3,
  "offerId": "1042303890832",
  "title": "适用iPhone17promax渐变磁吸手机壳磨砂苹果16高级感15防摔保护套",
  "url": "https://detail.1688.com/offer/1042303890832.html",
  "image": "https://cbu01.alicdn.com/img/ibank/O1CN01yp9iTc1gezw62LhMZ_!!2212690464168-0-cib.jpg",
  "images": [
    "https://cbu01.alicdn.com/img/ibank/O1CN01yp9iTc1gezw62LhMZ_!!2212690464168-0-cib.jpg"
  ],
  "price": 14.5,
  "currency": "CNY",
  "priceTiers": [
    {
      "quantityText": "1~199个",
      "minQuantity": 1,
      "maxQuantity": 199,
      "price": 14.5
    },
    {
      "quantityText": "200~7999个",
      "minQuantity": 200,
      "maxQuantity": 7999,
      "price": 14.0
    },
    {
      "quantityText": "≥8000个",
      "minQuantity": 8000,
      "maxQuantity": null,
      "price": 13.0
    }
  ],
  "soldText": "已售100+件",
  "sold": 100,
  "repurchaseRatePercent": 55.0,
  "serviceTags": [
    "深度验商"
  ],
  "promotionTags": [],
  "tags": [
    "退货包运费",
    "先采后付",
    "回头率55%"
  ],
  "brand": null,
  "sponsored": false,
  "supplier": {
    "name": "深圳市罗湖区洪星电子商行",
    "loginId": "深圳洪星生产",
    "memberId": "b2b-22126904641686ef2e",
    "shopUrl": "https://shop306x909028029.1688.com",
    "yearsOnPlatform": 5,
    "province": "广东",
    "city": "深圳市",
    "factoryInspected": false,
    "businessInspected": true,
    "superFactory": false,
    "tradeScores": {
      "composite": 4.0,
      "consultation": 1.5,
      "logistics": 4.0,
      "disputes": 4.0,
      "returns": 4.0,
      "goods": 3.0
    }
  }
}

The key-value store also holds:

• QUERIES - per query: total results 1688 reports, filters, pages fetched, offers collected and whether more pages exist.
• ERRORS - queries that returned no offers (no match, a word 1688 does not search, blocked) with the reason. These are not billed.

Pricing

$0.90 per 1000 offers. You pay only for offers delivered; queries without results are not charged.

Notes

• Prices are 1688's yuan (CNY) wholesale prices; price is the first tier of priceTiers.
• sold is the lower bound of 1688's sold label (已售100+件 -> 100).
• Sponsored offers are part of 1688's results and are flagged with sponsored: true.