1688 Wholesale Scraper - Products, Price Tiers, MOQ & Supplier Leads

Scrape 1688.com, Alibaba's China-domestic wholesale platform and the sourcing spine behind most Shopee / Lazada / TikTok Shop / Temu / Amazon sellers.

One merged record per offer: the tiered wholesale price ladder, minimum order quantity, repurchase rate, lifetime units sold, factory verification badges, the full product attribute table, and the supplier lead (company name + direct storefront URL).

No login. No browser. No cookies to supply. Just keywords in, structured wholesale data out.

---

Why this one

Most 1688 actors are one-trick: listings or products or suppliers. This returns the whole sourcing picture in a single row, including two signals nobody else exposes:

• Repurchase rate (复购率) - 1688's own repeat-buyer percentage. The single best proxy for "will this supplier actually deliver twice", and it is on every listing.
• The tiered price ladder - the real wholesale price at each minimum quantity, not just the headline number.

Chinese service tags and commitments are also returned translated to English, so the dataset is usable by buyers who do not read Chinese.

What you get per offer

Listing - offer ID, title, URL, image, price, recent transaction count, repurchase rate, supplier city, TrustPass membership years, deep-verified-factory / verified-supplier / powerful-merchant / hot-selling flags, sponsored flag, service tags (CN + EN), search rank, and the total result count for the keyword.

Detail & supplier lead (when Include full offer details is on, the default): tiered price ladder [{price, minQuantity}], min/max price, minimum order quantity, available stock, lifetime units sold, want-to-buy count, mixed-batch support, unit + unit weight, courier and dispatch window, supplier province/city, the full attribute table (brand, model, materials, specifications - 33 fields on our sample), every product image, the product video, and the supplier lead: company name, seller login ID, seller user ID, member ID and storefront URL.

Input

Field	Type	Notes
keywords	array	Product keywords. Chinese returns the richest results (耳机, 手机壳, 数据线, 女装, 包装盒). English also works (earphones -> 301 results, phone case -> 2,000).
startUrls	array	1688 search/category URLs to scrape directly.
maxItems	integer	Total offers to return. Default 100.
maxPagesPerKeyword	integer	Result pages per keyword (~20 offers each). Default 5.
includeDetails	boolean	Open each offer page for price tiers, MOQ, attributes and the supplier lead. Default on.
detailConcurrency	integer	Parallel detail fetches, 1-6. Default 4.
proxyCountryCodes	array	Residential proxy countries to rotate through. Default: a sensible mix.
proxyConfiguration	object	Residential proxy strongly recommended.

Leave the input empty and the actor runs a small sample search rather than failing - so a blank run still returns real data.

{
  "keywords": ["耳机", "phone case"],
  "maxItems": 100,
  "includeDetails": true
}

Example output (trimmed)

{
  "offerId": "898449197083",
  "title": "26新款华强北7代蓝牙耳机运动降噪耳机蓝牙长续航高音质无线耳",
  "url": "https://m.1688.com/offer/898449197083.html",
  "price": 15.07,
  "currency": "CNY",
  "priceTiers": [{ "price": 15.86, "minQuantity": 1 }],
  "minOrderQuantity": 1,
  "stockAvailable": 101534488,
  "salesCount": 3000,
  "totalSold": 6054,
  "repurchaseRate": 18,
  "supplierCity": "深圳市",
  "supplierLocation": "广东深圳",
  "companyName": "深圳市信业禾科技有限公司",
  "supplierUrl": "https://winport.m.1688.com/page/index.html?memberId=b2b-...",
  "brand": "华强北",
  "isVerifiedFactory": true,
  "isPowerfulMerchant": true,
  "serviceTags": ["深度验厂"],
  "serviceTagsEn": ["Deep-verified factory"],
  "courier": "常发中通快递",
  "deliveryLimitDays": 1,
  "attributes": { "耳机类别": "耳塞式耳机", "品牌": "华强北", "型号": "L1" }
}

How it works

1688's mobile surface (m.1688.com) is fully server-rendered - both search results and the offer page's window.__INIT_DATA blob. So the whole scrape is HTTP + parsing: no headless browser, which keeps runs fast and cheap and removes an entire class of breakage.

1688 rate-limits per IP rather than blocking outright. Each worker session therefore primes on the mobile homepage, carries its own cookie jar, and rotates to a fresh residential IP the moment an anti-bot interstitial appears. Measured 8/8 (100%) on rotating residential sessions.

If 1688 does throttle every attempt, the run still ends Succeeded with a status message asking you to re-run - never a crash, and on pay-per-event you are charged only for records you actually receive.

Use with AI assistants (MCP)

This actor works as a tool in any MCP-compatible assistant (Claude, Cursor, VS Code). Point your MCP client at the Apify MCP server and ask it to source products - it can search 1688 and return structured supplier data without you writing any code.

Agent-ready: autonomous payments (x402 & Skyfire)

This actor is agent-ready — AI agents can discover it, run it, and pay for it autonomously, with no Apify account and no human in the loop. It uses pay-per-event pricing and limited permissions, so it qualifies for Apify's agentic-payment standards:

• x402 — an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the Apify MCP server — no account, no API key.
• Skyfire — agent-to-service payments for fully autonomous AI-agent workflows.

Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes.

Pricing

Pay-per-event - you pay for records returned, not for runtime:

Event	Price	What it covers
Offer scraped	$0.003	One listing record from search/category
Offer detail & supplier lead	$0.006	Full record: price tiers, MOQ, stock, attributes, images, supplier lead

No start fee and no charge for pagination.

Notes & honest limits

• No sort option is exposed. m.1688.com's search endpoint ignores sortType (verified across booked / priceUp / price_asc / va_price / normal - none produced sorted output), so rather than ship a control that silently does nothing, there isn't one.
• trustPassYears, serviceTags and videoUrl are honestly sparse. Only TrustPass member suppliers display membership years, only qualifying suppliers get service badges, and only some offers have a product video. These are source-gated, not extraction gaps.
• Prices are in CNY, and titles/attributes are in Chinese (with service tags translated).
• Scrapes public data only. No login, and no personal data beyond the public seller storefront.