🛒 1688 Product Scraper — wholesale sourcing & factory-direct supply

Extract wholesale product data from 1688.com: bulk-tier pricing, six seller credit sub-scores, sales volume, repurchase rate, certification badges. Batch-collect by keyword. No login required.

---

🎯 What you can do

• Batch keyword search: up to 50 keywords per run, up to 1000 products per keyword
• 36 product fields: title, price, bulk-tier pricing, main image, shop, province, city, six credit sub-scores, sales, repurchase rate, return-customer rate, badges, service tags
• Filters available: price range, minimum seller rating, verified-shops-only
• Sort options: default / best-selling (sorted by 1688's in-platform best-seller signal)
• Multi-language input: Traditional Chinese, Simplified Chinese, and English keywords all supported (subject to 1688's catalog coverage)

---

📥 Input fields

Field	Type	Required	Description
queries	array of strings	✅	Search keywords for batch collection (e.g. dress, phone case, air fryer)
maxProducts	integer (60–1000)	optional, default 60	Max products to extract per keyword
sortType	enum	optional, default normal	normal / best_selling (sorted by 1688's in-platform best-seller signal)
priceMin	integer	optional	Minimum unit price (CNY)
priceMax	integer	optional	Maximum unit price (CNY)
sellerRatingMin	number (0–5)	optional	Minimum seller composite score (e.g. 4.5 keeps only shops scoring 4.5+)
verifiedOnly	boolean	optional, default false	When enabled, keeps only on-site-verified shops (factory inspection or business inspection)

---

📤 Output sample

{
  "offer_id": "1035753446015",
  "title": "3th Morning 奶油甜茶 韩系复古水果印花圆领短袖T恤ZY4091",
  "offer_url": "https://detail.1688.com/offer/1035753446015.html",
  "main_image": "https://cbu01.alicdn.com/img/ibank/O1CN01rX4sLe21ayNq1aDEN_!!2211360847002-0-cib.jpg",
  "price_cny": "42",
  "quantity_prices": [{"quantity": "≥1件", "value": "42.00"}],
  "shop_name": "苏州智允服饰设计有限公司",
  "shop_province": "江苏",
  "shop_city": "苏州市",
  "business_type": "生产加工",
  "shop_years": "6",
  "verified_seller": true,
  "factory_inspection": true,
  "business_inspection": true,
  "booked_count": 437,
  "total_sales_text": "已售400+件",
  "repurchase_rate": "1%",
  "turn_head_rate": "64%",
  "composite_score": "4.5",
  "consultation_score": "4.5",
  "logistics_score": "3.57",
  "dispute_score": "4.0",
  "return_score": "4.67",
  "goods_score": "3.0",
  "badges": ["退货包运费", "先采后付", "回头率64%"],
  "service_tags": ["7×24H响应", "深度验厂", "先采后付"],
  "search_keyword": "T恤",
  "search_page": 1,
  "extracted_at": "2026-04-26T20:08:54Z"
}

Text fields (titles, shop names, badges, service tags) are returned in their original Simplified Chinese as published on 1688.com.

See the dataset default view for all 36 fields.

---

💡 Use cases

• Cross-border e-commerce sourcing: pull best-selling items + factory-direct data, list on Shopify, Amazon, Shopee, Rakuten
• Wholesaler price comparison: compare unit prices, bulk-tier prices, and seller credit scores across keywords in the same category
• Category intelligence: monitor sales volume, repurchase rate, and pricing changes within a category over time
• Buying-list management: batch-collect product URLs + images + prices to build a procurement list

---

🔗 Affiliate

This Actor is published by futurizerush. If this tool helps you, signing up via this link is a small way to support the author. Thank you.

---

❓ FAQ

Q1: Why do some keywords return 0 results when I run many at once?

1688 occasionally throttles traffic, so a few keywords may return 0 in any given run. The Actor moves on to the next keyword after a friendly warning — partial results are still saved.

Q2: Why do different products have different numbers of quantity_prices tiers?

1688 merchants set their own bulk-tier pricing. Retail-friendly merchants typically set a single tier "≥1 piece"; traditional wholesalers set multiple tiers (e.g. 199 / 100499 / ≥500); a few merchants set no tiers, in which case quantity_prices is an empty array.

Q3: Do image URLs expire?

Image URLs are usually stable, but merchants may change images when re-listing. For long-term storage, download and back up the images at extraction time.

Q4: Will this Actor get me blacklisted on 1688?

This Actor runs entirely anonymously — no login, no account credentials attached — so your 1688 account is never exposed to risk.

Q5: Can I extract the full SKU matrix from product detail pages?

No. This Actor extracts search-page summary data only. Full SKU and specification matrices live on each product's detail page and are not within this Actor's scope.

---

⚠️ Disclaimer

This Actor extracts only publicly visible product information from 1688.com. It does not access any login-protected content, submit orders, or modify seller pages. Data accuracy, freshness, and availability depend on 1688's on-site display and may vary due to platform changes or merchant updates. This tool is not investment advice or legal counsel; users should evaluate data compliance and commercial use independently.

Extracted data is information published by 1688 merchants themselves; copyright and related rights belong to the original publishing merchants. Please comply with 1688's Terms of Service and applicable local laws.

---

Built with Claude Code, OpenClaw, Gemini, Antigravity, Codex, ChatGPT.