1688 Wholesale Scraper: Products, Pricing, SKUs & Suppliers

Scrape wholesale products from 1688.com (Alibaba's China B2B marketplace) by keyword or offer ID. Every result is one product with 50+ structured fields: tiered wholesale pricing, minimum order quantity, the full SKU variant matrix, stock, images and video, product attributes, supplier verification, dropship/distribution channels, coupons and mixed-batch rules.

Unofficial. This Actor is not affiliated with, endorsed by, or sponsored by 1688.com, Alibaba or any supplier. "1688" and supplier/brand names are trademarks of their respective owners and are used here only to describe the data the Actor returns. It extracts publicly visible product and supplier listing data only - no personal data and no login.

🚀 How to use

1. Click Try for free / Start.
2. Type one or more keywords - English (wireless earbuds, phone case) or Chinese (手机壳, 蓝牙耳机). Chinese keywords usually return more results.
3. (Optional) Instead of keywords, paste specific Offer IDs to scrape exactly those products. The ID is the number in any product URL: offerId=735353578254.
4. Set Max results per keyword, an optional price range or MOQ, and run.
5. Download the results as JSON, CSV, Excel, HTML or via API.

✨ Features

• 🔎 Keyword or offer-ID input - search in Chinese or English, or scrape exact products by ID. Cross-keyword duplicates are removed automatically.
• 💲 Tiered wholesale pricing - the full quantity-break ladder (beginAmount → endAmount → price), min/max price, currency and price display.
• 📦 Order terms - minimum order quantity, live stock, unit, unit weight and mixed-batch (混批) rules (min pieces / min amount).
• 🎨 SKU variant matrix (optional) - every color/size/model combination with its own SKU id, spec attributes, per-variant stock and sales count.
• 🏷️ Product attributes - material, style, craft, features and the rest of the structured spec table, plus category path and brand.
• 🖼️ Media - main image gallery, detail images, and the product video URL.
• 🏭 Supplier profile - company name, member id, seller type, shop URL, verification/trade-assurance flags, service score, positive-feedback rate and repeat-purchase rate, plus province/city.
• 🚚 Distribution & dropship intelligence (optional add-on) - the resale channels the supplier authorizes (Taobao, Douyin, Amazon, Shopify, Shopee …), recent order volume, delivery terms and buyer-protection services.
• 📝 Descriptions - detail-image URLs and a plain-text description are always included; the full HTML description is an optional toggle.

🧭 Input

Field	Type	Description
keywords	array	Product keywords (English or Chinese). Searched independently. Ignored if offerIds is set.
offerIds	array	Specific product IDs to scrape directly (skips search).
maxResults	integer	Max products per keyword. Default 50.
sortBy	string	relevance, bestSelling, priceAsc, priceDesc.
includeSkuDetails	boolean	Add the full SKU variant matrix. Default false.
includeDescriptionHtml	boolean	Add the raw HTML description. Default false.
includeSupplierIntelligence	boolean	Add distribution/dropship intelligence. Default false.
priceMin / priceMax	integer	Only include products in this unit-price range (CNY).
minOrderQuantity	integer	Only include suppliers whose MOQ is ≤ this value.
proxyCountry	string	Country requests are routed through. China recommended.

Example input

{
  "keywords": ["wireless earbuds", "手机壳"],
  "maxResults": 50,
  "sortBy": "bestSelling",
  "includeSkuDetails": true,
  "includeSupplierIntelligence": true,
  "priceMax": 50
}

Scrape specific products instead:

{
  "offerIds": ["735353578254"],
  "includeSkuDetails": true
}

📤 Output

One record per product. Abbreviated example:

{
  "offerId": "735353578254",
  "url": "https://detail.1688.com/offer/735353578254.html",
  "title": "适用iphone17PRO大视窗磁吸手机壳15磨砂漏标苹果16秒变17保护套",
  "brandName": "潮虹兔",
  "categoryName": "iPhone保护套",
  "unit": "个",
  "currency": "CNY",
  "priceMin": 9,
  "priceMax": 9,
  "priceTiers": [
    { "beginAmount": 2, "endAmount": 499, "price": 9, "discountPrice": 9 }
  ],
  "minOrderQuantity": 2,
  "stock": 2327560,
  "saleCount": "1.3万+",
  "unitWeight": 0.03,
  "mixSupported": true,
  "mixAmount": 5,
  "mixNumber": 2,
  "attributes": { "材质": "PC", "款式": "全包款", "工艺": "磨砂" },
  "mainImage": "https://cbu01.alicdn.com/img/ibank/...jpg",
  "images": ["..."],
  "detailImages": ["..."],
  "videoUrl": "https://cloud.video.taobao.com/play/...mp4",
  "supportsDropship": true,
  "isCrossBorder": true,
  "sellerCompanyName": "深圳市亿佳合兴科技有限公司",
  "sellerMemberId": "b2b-38721316754ec7c",
  "sellerType": "slsj",
  "shopUrl": "https://shop764420m281617.1688.com",
  "isTradeAssurance": true,
  "sellerServiceScore": "4.5分",
  "goodRate": 99.6,
  "repeatPurchaseRate": "57.69%",
  "sellerProvince": "广东省",
  "sellerCity": "深圳市",
  "skus": [
    { "skuId": 5994388491498, "specAttributes": "梅红>iPhone 12", "stock": 9999, "saleCount": 0 }
  ],
  "supplierIntelligence": {
    "distributionChannels": ["淘宝", "抖音", "Amazon", "Shopify", "Shopee"],
    "recentOrderVolume": "7000+",
    "deliveryDays": 2
  },
  "keyword": "手机壳"
}

The dataset ships with three table views: Overview, Pricing & variants and Suppliers.

💰 Pricing

This Actor is pay per result - you are charged per product returned. The optional supplier-intelligence add-on adds a small per-product charge only when you switch it on. See the Pricing tab for current rates.

⚙️ How it works

Just give it keywords or offer IDs and run - no account, login or cookies needed. 1688 is a domestic Chinese marketplace that serves its most complete data to local shoppers, so the Actor collects results as a China-based buyer would see them (set Proxy country to change this). Each product is returned as one clean, structured record.

❓ FAQ

• English or Chinese keywords? Both work. Chinese keywords typically return many more results because 1688 is a domestic Chinese marketplace.
• Where do I find an offer ID? It's the number in any product URL, e.g. detail.1688.com/offer/735353578254.html → 735353578254.
• Prices are in CNY (Chinese yuan). Convert to your currency as needed.
• Some fields are empty for a product. Suppliers don't fill every field; the Actor returns whatever the listing exposes.

⚖️ Legal

Use the data responsibly and in line with applicable laws and 1688's terms. This Actor returns only publicly available listing information and no personal data.