1688 Product Scraper

Turn 1688.com (阿里巴巴 China wholesale) into a spreadsheet of sourcing-ready products: the full MOQ price ladder, minimum order quantity, supplier company and trust badges, sales counts, ships-from province and city, images, attributes and (for product pages) every SKU variant with stock. Search by keyword, or paste product URLs / offer IDs. No 1688 account, no cookies.

Built for sourcing agents, importers, Amazon/Shopify/Shopee sellers and dropshippers who compare factory-direct prices before they contact a supplier, and for developers feeding a catalog, ERP or AI sourcing agent.

What you get

One row per product, the same shape for keyword and URL inputs:

Field	Description
offerId, url, title	Offer ID, product page URL, Chinese title as published
price, priceMax, currency	Lowest tier price and MOQ price in CNY
priceTiers	The wholesale ladder: [{minQuantity, maxQuantity, price}], e.g. 2–499 → ¥9.00, 500–4999 → ¥8.50, ≥5000 → ¥7.50
moq, unit	Minimum order quantity and selling unit (个 / 件 / 套 …)
salesCount, salesText, sales30Days, ordersCount, repurchaseRate	Demand signals as 1688 shows them
companyName, sellerLoginId, sellerMemberId, shopUrl, sellerYears	Supplier identity and storefront
isVerifiedSupplier, isFactory, sellerTags, bizType	TrustPass (诚信通), manufacturer / 实力商家, badges such as 深度验厂, 7天包换, 48小时发货
province, city, shippingLocation, deliveryPromise, deliveryDays, unitWeightKg, freeShipping	Where it ships from and how fast
images, mainImage, videoUrl	Media URLs (CDN, no login needed)
attributes	[{name, value}] — material, style, function, applicable models …
categoryId, categoryName, categoryPath, brand	1688 category
skus, skuProps	SKU variants [{skuId, specAttrs, price, stock, salesCount}] and the variant dimensions (product-page rows)
rating, goodRatePercent, reviewCount, favoriteCount, serviceScore	Reputation (product-page rows)
supportsMixedWholesale, mixMinQuantity, mixMinAmount, stockTotal	Mixed-batch terms and bookable stock
isAd, keywords, source, scrapedAt	Promoted-listing flag, originating keyword, search or detail, timestamp

Fields marked product-page rows are filled for productUrls / offerIds inputs and for keyword results when Fetch full detail for search results is on. Keyword rows without enrichment carry the price ladder, MOQ, supplier, sales, location, category IDs, one image and the headline attributes.

Use cases

• Supplier shortlists — search a product, filter by MOQ ceiling and price range, compare real quantity-break prices side by side.
• Landed-cost checks — read the price at your order size instead of the "from" price.
• Catalog refresh — feed your tracked offer IDs on a schedule and watch price ladders, stock and sales move.
• Factory sourcing — keep only isFactory suppliers in one province so one freight consolidation covers the order.
• Market research — sales counts, repurchase rates and review volumes across a whole keyword.

Input

Parameter	Type	Description
keywords	array	Search terms. Chinese keywords return the most results; English works for common product names. Up to 2,000 offers per keyword (1688's cap).
productUrls	array	detail.1688.com/offer/<id>.html or m.1688.com/offer/<id>.html links — full product data.
offerIds	array	Numeric offer IDs, same output as URLs.
maxItems	integer	Total products to save (default 100).
sortBy	select	default (best match), sales, price_asc, price_desc.
enrichSearchResults	boolean	Open each search hit's product page for SKUs, all attributes, images, rating, shipping. Default off.
priceMin, priceMax	integer	Lowest-tier price range in CNY.
maxMoq	integer	Keep suppliers whose minimum order is at most this many units.
includeAds	boolean	Keep promoted listings (isAd: true). Default on.
proxyConfiguration	object	Use Apify RESIDENTIAL proxies. 1688 serves only a handful of requests per IP before it shows a slider; residential rotation on every request is what keeps the run going. Datacenter IPs are blocked almost immediately.

Example input

{
  "keywords": ["保温杯", "wireless earbuds"],
  "productUrls": ["https://detail.1688.com/offer/735353578254.html"],
  "maxItems": 200,
  "sortBy": "sales",
  "maxMoq": 50,
  "enrichSearchResults": false,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}

Example output (product page)

{
  "offerId": "735353578254",
  "url": "https://detail.1688.com/offer/735353578254.html",
  "title": "适用iphone18PRO大视窗磁吸手机壳15磨砂漏标苹果11秒变17保护套",
  "price": 7.5,
  "priceMax": 9.0,
  "currency": "CNY",
  "priceTiers": [
    { "minQuantity": 2, "maxQuantity": 499, "price": 9.0 },
    { "minQuantity": 500, "maxQuantity": 4999, "price": 8.5 },
    { "minQuantity": 5000, "maxQuantity": null, "price": 7.5 }
  ],
  "moq": 2,
  "unit": "个",
  "salesCount": 17000,
  "salesText": "1.7万+",
  "sales30Days": 20000,
  "companyName": "深圳市亿佳合兴科技有限公司",
  "shopUrl": "https://shop764420m281617.1688.com",
  "isVerifiedSupplier": true,
  "isFactory": true,
  "sellerTags": ["一件代发", "镇店之宝"],
  "province": "广东省",
  "city": "深圳市",
  "deliveryPromise": "承诺48小时发货·常发韵达快递",
  "deliveryDays": 2,
  "unitWeightKg": 0.03,
  "images": ["https://cbu01.alicdn.com/img/ibank/O1CN01lAdPke1OFCTM0qUJK_!!3872131675-0-cib.jpg", "..."],
  "attributes": [{ "name": "材质", "value": "PC" }, { "name": "功能", "value": "其它,磁吸,防摔,抗指纹" }],
  "categoryId": "1046694",
  "categoryName": "iPhone保护套",
  "brand": "潮虹兔",
  "rating": 5.0,
  "goodRatePercent": 99.6,
  "reviewCount": 22447,
  "skus": [{ "skuId": "5994388491383", "specAttrs": "海军蓝【纳米磨砂防指纹手汗】>iPhone 15PLUS", "stock": 9999, "salesCount": 0 }],
  "skuProps": [{ "name": "颜色", "values": ["樱桃红", "橙色", "..."] }, { "name": "适用型号", "values": ["iPhone 15PLUS", "..."] }],
  "source": "detail",
  "scrapedAt": "2026-10-05T03:10:22Z"
}

Scheduling and integrations

Run it on a schedule from the Apify Console to refresh a tracked list of offer IDs, add a webhook to get notified when a run finishes, or pull the dataset straight into Google Sheets, Make, Zapier or your own code through the Apify API. Every run writes an OUTPUT record to the key-value store with the number of products saved and any offers that could not be fetched (not_found, blocked), so partial results are never silent.

Use with AI assistants and MCP

Add this Actor to an AI assistant through the Apify MCP server and ask in plain language: "find 1688 suppliers for insulated bottles with MOQ under 50 and list price tiers". The assistant fills the input, runs the Actor and reads the dataset back.

FAQ

Do I need a 1688 account or cookies? No. Everything the Actor reads is public to anonymous visitors.

Why residential proxies? 1688 limits anonymous traffic per IP (a few product pages, a dozen search calls) and then shows a slider captcha. The Actor never solves captchas; it rotates to a fresh residential IP on every request instead. With datacenter IPs or no proxy, the run stops early with a clear "Blocked" status and keeps whatever it already saved.

Are titles translated? No — titles and attributes are delivered exactly as the supplier published them (Chinese). Keep them for pasting back into 1688 or sending to an agent; translate downstream if you need English.

How many results per keyword? 1688's search reports at most 2,000 offers per keyword. Use several keywords or the price / MOQ filters to go deeper.

Are prices live? Yes, every row is fetched at run time; scrapedAt tells you when. Prices are in CNY as shown to a guest visitor; logged-in or member prices can differ.

What about products that disappear? Removed offers are reported in the run's OUTPUT record as not_found and are not charged.

Is this legal? The Actor collects publicly available product listings only. You are responsible for using the data in line with 1688's terms and the laws that apply to you.