1688 Wholesale Scraper

Turn 1688.com into a clean wholesale supplier feed. Product specs, tiered wholesale pricing, every available color and size, supplier trust signals and buyer reviews, structured and ready for analysis. In seconds, not hours.

How it works

Type a product keyword in English or Chinese, or paste the offer IDs you already have, and press Start. Every result comes back as one structured record: pricing tiers, variant options, supplier profile, after-sales guarantees and a buyer review summary. Export to JSON, CSV or Excel, or pull it straight into your sourcing pipeline.

Three steps, no setup:

1. Search or paste IDs. Enter keywords (wireless earbuds or 蓝牙耳机) or a list of offer IDs.
2. Get structured records. Each product returns pricing, variants, supplier and reviews as clean fields, not a wall of Chinese HTML.
3. Export or pipe. Download as JSON, CSV, Excel, or read the dataset from the API into your own tools.

✨ Why teams choose this over other 1688 scrapers

Sourcing from 1688 by hand means copy-pasting Chinese product pages, guessing where the price actually breaks, and never knowing if a supplier is a real factory or a reseller. Running scrapers that hand back half the fields and break on the first run? Paying extra to unlock supplier and factory details other tools hide behind a toggle?

• ⭐ Buyer reviews on every product. Star rating, positive rate, and the exact words buyers use (fast shipping, great quality, responsive seller) with sample reviews and the variant each buyer bought. Most 1688 scrapers give you no reviews at all. This one reads buyer sentiment so you can spot a proven product before you contact the supplier.
• 🎨 Every color and size, reliably. The available variant options come back on every product that has them, straight from the product page. You see the full choice set (colors, sizes, models) even for listings other scrapers return half-empty.
• 🏭 Supplier details come free. Company name, location, factory or trade type, repeat-buyer rate, response rate, platform credentials and service scores, included with every product instead of sold as a paid add-on.
• 💰 The real price breaks on every product. The tiers that matter (10 units at one price, 1000 at another) come back as structured steps, so you can compare true unit cost across suppliers instead of eyeballing a headline price.
• 🛡️ Trust and demand signals built in. After-sales guarantees (quality guarantee, breakage and late-shipment compensation), buyer protections, monthly sales and 30-day sales value, so you can vet a supplier and gauge real demand in one row.
• 📋 Full product specs. Chip type, material, function, model and the rest, as clean name and value pairs, not buried in a description blob.
• 🖼️ Full image gallery and video. Every product image plus the product video when the supplier posts one, not just a single thumbnail.
• ⚡ Fast by default, deep on demand. Product, pricing, variants, reviews and supplier come from a single fast pass. Turn on the per-variant matrix (each color and size with its own stock and price) only when you need that depth.
• 🌏 Search in English or Chinese. Type wireless earbuds or 蓝牙耳机. Chinese keywords reach the full domestic catalog and return far more suppliers.
• 🎯 Strict result cap. Set Max results and get exactly that. No surprise overage from a scraper that ignores your limit.

🎯 What you can do with 1688 data

Team	What they build
Sourcing	A shortlist of factories for a product, ranked by price break, minimum order and repeat-buyer rate, with supplier guarantees on each row
E-commerce	A landed-cost and margin model from cost, variants and shipping weight before importing a single unit
Dropshipping	A catalog of low-MOQ suppliers with consignment support and the exact colors and sizes each offers
Private label	A factory comparison by years on platform, review sentiment, response rate and verification status
Market research	A view of wholesale price ranges and best-selling products across a category, tracked over time
Procurement	A weekly watch on a set of offer IDs for price, stock and minimum-order changes
Agencies	A supplier database refreshed on a schedule and fed to clients as clean CSV or a Google Sheet

📥 Input parameters

Field	Type	Description
keywords	array	Products to search for, English or Chinese. Each keyword is searched separately and Max results applies per keyword.
offerIds	array	Specific product IDs to scrape directly. When set, keywords are ignored.
maxResults	integer	Maximum products per keyword. Default 100.
sortBy	string	relevance, bestSelling, priceAsc or priceDesc.
includeSkuMatrix	boolean	Also return the per-variant matrix (each color and size with its own stock and price). Off by default for the fastest runs. Colors, sizes, pricing, reviews and supplier come regardless.
proxyConfiguration	object	Residential proxy, selected by default and routed automatically.
debugMode	boolean	Extra diagnostics for troubleshooting. Leave off for normal runs.

📊 Output data

Each product is one record. Search results and offer-ID lookups return the same shape.

{
  "offerId": "1063153988432",
  "title": "Summer floral V-neck maxi dress, cross-border women's fashion",
  "detailUrl": "https://detail.1688.com/offer/1063153988432.html",
  "images": ["https://cbu01.alicdn.com/img/ibank/O1CN01...jpg"],
  "videoUrl": "https://cloud.video.taobao.com/play/u/.../e/6/t/1/....mp4",
  "price": { "min": 20.0, "max": 22.0, "currency": "CNY", "display": "20.00-22.00" },
  "quantityPrices": [
    { "price": 22.0, "beginAmount": 2, "endAmount": 99 },
    { "price": 20.0, "beginAmount": 100, "endAmount": 0 }
  ],
  "minOrderQuantity": 2,
  "stock": 15773,
  "soldCount": 322,
  "unitWeight": 0.42,
  "skuProperties": [
    { "name": "颜色", "values": ["Green (ships in 24h)", "Blue (presale)", "Custom color and size"] },
    { "name": "尺码", "values": ["S", "M", "L", "XL", "XXL"] }
  ],
  "services": [
    { "name": "Quality guarantee", "description": "Third-party inspection before you confirm receipt; claim if goods do not match." },
    { "name": "Late-shipment compensation", "description": "Compensation when the seller ships later than agreed." }
  ],
  "buyerProtections": ["Ships in 48h", "7-day exchange"],
  "monthlySales": 3205,
  "gmv30Days": 50000,
  "dropship": { "enabled": true },
  "supplier": {
    "companyName": "Guangzhou Caisi Garment Co., Ltd.",
    "memberId": "b2b-2222623069593...",
    "loginId": "caisi001",
    "sellerType": "factory",
    "repeatRate": "23%",
    "responseRate": "96%",
    "certifications": ["TrustPass 4 years"],
    "serviceScores": { "goods": "4.8", "logistics": "4.9" },
    "location": "Guangdong Guangzhou"
  },
  "reviews": {
    "total": 1800,
    "rating": 5.0,
    "goodRate": 99.9,
    "items": [
      { "rating": 5.0, "content": "Great quality, ships fast", "sku": "型号:白色100CM", "date": "2025-07-14" }
    ]
  },
  "sourceType": "search",
  "scrapedAt": "2026-07-02T00:00:00Z"
}

When you turn on includeSkuMatrix, products that expose it also carry a skuVariants array, one row per color and size:

{
  "skuVariants": [
    { "skuId": "6130776786823", "specId": "f561c4f7...", "specs": "Black / M", "stock": 7890, "saleCount": 12 },
    { "skuId": "6130776786824", "specId": "a63c985e...", "specs": "White / L", "stock": 7883, "saleCount": 4 }
  ]
}

🗂️ Data fields

Category	Fields
Identity	offerId, title, detailUrl, sourceType, sourceKeyword, scrapedAt
Media	images (full gallery), videoUrl
Pricing	price (min, max, currency, display), quantityPrices (tiered: price, beginAmount, endAmount)
Variants	skuProperties (variant options: name plus every value, colors and sizes), skuVariants (per-variant skuId, specId, specs, stock, saleCount, opt-in), minOrderQuantity, stock, soldCount, unitWeight
Trade	dropship (enabled), customization, isCrossBorderTrade, shipping (location, postFee, deliveryDays, freeShipping)
Trust and demand	services (after-sales guarantees, each with name and a plain-language description), buyerProtections, monthlySales, gmv30Days
Supplier	companyName, legalCompanyName, memberId, loginId, sellerType, isVerified, repeatRate, responseRate, certifications, serviceScores, winportUrl, location
Reviews	total, rating, goodRate, withImagesCount, impressionTags (sentiment keyword plus count), items (per review: rating, content, date, sku, images)

The supplier object carries up to 12 populated fields, reviews up to 6 top-level fields plus a sample of individual reviews with 5 fields each, and price 4. offerId and detailUrl are stable and permanent; image URLs stay valid for a couple of weeks; the product video URL is a CDN link that can expire sooner. Timestamps are ISO 8601 (scrapedAt).

🚀 Examples

Find wireless earbud suppliers

{ "keywords": ["wireless earbuds"], "maxResults": 100 }

Search the domestic catalog in Chinese

{ "keywords": ["蓝牙耳机", "充电宝"], "maxResults": 200 }

Find the cheapest suppliers first

{ "keywords": ["phone case"], "sortBy": "priceAsc", "maxResults": 50 }

Pull the best-selling products in a category

{ "keywords": ["LED strip lights"], "sortBy": "bestSelling", "maxResults": 100 }

Get per-variant stock and price for apparel

{ "keywords": ["卫衣 女"], "includeSkuMatrix": true, "maxResults": 60 }

Audit specific products you already source

{ "offerIds": ["1063153988432", "738026063940"] }

🤖 Copy to your AI assistant

Paste this block into Claude, ChatGPT or Cursor to give it full context about this scraper:

You have access to the 1688 Wholesale Scraper on Apify: silentflow/1688-scraper

Input schema:
- keywords (array of strings): products to search, English or Chinese
- offerIds (array of strings): specific product IDs; when set, keywords are ignored
- maxResults (integer, default 100): products per keyword
- sortBy (string): relevance | bestSelling | priceAsc | priceDesc
- includeSkuMatrix (boolean, default false): also return per-variant stock and price
- debugMode (boolean, default false)

Output per product:
- offerId, title, detailUrl, images[], videoUrl
- price { min, max, currency, display }
- quantityPrices[] { price, beginAmount, endAmount }  (tiered wholesale pricing)
- skuProperties[] { name, values[] }  (variant options: colors, sizes)
- skuVariants[] { skuId, specId, specs, stock, saleCount }  (per-variant, opt-in)
- minOrderQuantity, stock, soldCount, unitWeight
- services[] { name, description }, buyerProtections[], monthlySales, gmv30Days
- dropship { enabled }, customization, isCrossBorderTrade, shipping { location, postFee, deliveryDays, freeShipping }
- supplier { companyName, memberId, loginId, sellerType, isVerified, repeatRate, responseRate, certifications[], serviceScores, winportUrl, location }
- reviews { total, rating, goodRate, withImagesCount, impressionTags[] { name, count }, items[] { rating, content, date, sku, images } }
- sourceType, sourceKeyword, scrapedAt

No login, no API key. Proxies included. Use apify-client for Python or JS.

💻 Integrations

Build a supplier shortlist in Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("silentflow/1688-scraper").call(run_input={
    "keywords": ["wireless earbuds"],
    "sortBy": "bestSelling",
    "maxResults": 100,
})

suppliers = []
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    s = item.get("supplier") or {}
    r = item.get("reviews") or {}
    suppliers.append({
        "title": item["title"],
        "unit_price": item["price"]["min"],
        "moq": item["minOrderQuantity"],
        "company": s.get("companyName"),
        "repeat_rate": s.get("repeatRate"),
        "good_rate": r.get("goodRate"),
    })

suppliers.sort(key=lambda x: (x["unit_price"], -(x["good_rate"] or 0)))
for s in suppliers[:10]:
    print(s)

Monitor price and stock changes in Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('silentflow/1688-scraper').call({
    offerIds: ['1063153988432', '738026063940'],
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const p of items) {
    console.log(`${p.offerId}: ${p.price.min} CNY, stock ${p.stock}, MOQ ${p.minOrderQuantity}`);
}

Export a category to CSV

import csv
from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("silentflow/1688-scraper").call(run_input={"keywords": ["phone case"], "maxResults": 200})

with open("suppliers.csv", "w", newline="") as f:
    w = csv.writer(f)
    w.writerow(["offerId", "title", "minPrice", "moq", "company", "monthlySales"])
    for it in client.dataset(run["defaultDatasetId"]).iterate_items():
        s = it.get("supplier") or {}
        w.writerow([it["offerId"], it["title"], it["price"]["min"], it["minOrderQuantity"], s.get("companyName"), it.get("monthlySales")])

📈 Performance

Metric	Value
Speed	Fast by default: product, pricing, variant options, reviews and supplier from a single pass
Depth on demand	Turn on includeSkuMatrix for per-variant stock and price when you need it
Always included	Tiered pricing, specs, variant options, gallery, shipping, supplier and review summary on every product
Search depth	Up to 2,000 products per keyword
Languages	English and Chinese keywords
Freshness	Live, fetched on demand at run time, no caching

💾 Data export

Every run writes to a dataset you can export as JSON, CSV, Excel, HTML or RSS from the Apify console, or pull programmatically:

https://api.apify.com/v2/datasets/{DATASET_ID}/items?format=csv&token=YOUR_TOKEN

💡 Tips for best results

• Use Chinese keywords for the widest selection. 1688 is a domestic Chinese marketplace, so 蓝牙耳机 returns far more suppliers than its English equivalent.
• Sort by bestSelling to surface proven products with real order volume before you contact a supplier.
• Read quantityPrices to find the order quantity where the unit price drops. The break point is often lower than the listing headline suggests.
• Use reviews.goodRate and the review samples to filter for products buyers actually like, then monthlySales to confirm real demand.
• Leave includeSkuMatrix off for fast category scans, and turn it on only for the shortlist where you need each color and size with its own stock and price.

❓ FAQ

What does the scraper return? A structured record per product: title, images, video, tiered pricing, variant options, minimum order quantity, stock, supplier profile, after-sales guarantees, buyer protections, demand signals and a buyer review summary.

What is 1688? 1688.com is Alibaba's domestic Chinese B2B wholesale marketplace, the factory-direct source that sits upstream of Alibaba.com and AliExpress. It is where most cross-border sellers buy at wholesale prices.

Can I search in English? Yes. English and Chinese keywords both work. Chinese keywords reach the full domestic catalog and return more results.

Do I need a 1688 account? No. The scraper reads publicly available product data. No login, no API key, no cookies.

How do I scrape a specific product? Put its offer ID (the number in the product URL) in the offerIds field. Keywords are ignored when offer IDs are set.

Does it return review text? Yes. Each review summary carries the total count, star rating, positive rate and top sentiment keywords, plus a sample of individual reviews with their text, star level, purchase date and the variant the buyer bought.

Do I get every color and size? The variant options (available colors, sizes and models) come on every product that lists them. For the deeper matrix with per-variant stock and price, turn on includeSkuMatrix; it is added when the product page exposes it.

How do the sort and filter options combine? sortBy applies to each keyword search, and maxResults caps each keyword separately. For example, keywords: ["phone case"] with sortBy: "bestSelling" and maxResults: 50 returns the 50 best-selling phone case offers.

How many products can I get per keyword? Up to 2,000 per keyword, capped by your Max results setting.

Is the price in dollars? Prices are in Chinese yuan (CNY), the currency 1688 lists in. The price object includes the currency so you can convert as needed.

Are the image and video links permanent? offerId and detailUrl are stable. Image URLs stay valid for a couple of weeks. The product video is a CDN link that can expire sooner, so download it if you need to keep it.

⚖️ Legal

This Actor extracts publicly available data from 1688.com. It does not bypass any login, paywall or CAPTCHA. Users are responsible for complying with 1688's terms of service and applicable data protection laws (GDPR, CCPA, and PIPL where relevant). When the output contains personal data, such as supplier contact names or reviewer nicknames, users must handle it accordingly. The data returned is informational; verify accuracy for regulated use cases.

🔗 Related scrapers

Building a China sourcing pipeline? See the full set of marketplace and supplier scrapers on our profile: silentflow on Apify.

📬 Support

Need something this scraper does not do yet? We ship features fast.

• Feature requests go straight to our backlog
• Enterprise needs? We do custom integrations and high-volume plans
• Pricing questions? Check the Monetization tab on the actor page

Response time: usually under 24 hours.

Check out our other scrapers: silentflow on Apify