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

Extract wholesale product data from 1688.com: bulk-tier pricing, seller multi-dimensional scoring, 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
• Comprehensive product fields: title, price, bulk-tier pricing, main image, shop, province, city, seller multi-dimensional scoring, sales, repurchase rate, return-customer rate, badges, service tags
• Filters available: price range, minimum seller rating, verified-shops-only
• Sort options: default / best-selling (best-sellers as ranked by 1688)
• 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 (Traditional/Simplified Chinese or English); submitting 3-5 keywords per run is recommended
maxProducts	integer (60–1000)	optional, default 60	Max products to extract per keyword
sortType	enum	optional, default normal	normal / best_selling (best-sellers as ranked by 1688)
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 1688-verified shops

---

📤 Output sample

The following is an illustrative output; actual values are determined by what 1688 merchants publish. Text fields (titles, shop names, badges, service tags) are returned in their original Simplified Chinese as published on 1688.com.

{
  "offer_id": "0000000000000",
  "title": "Example product title (set by the 1688 merchant)",
  "offer_url": "https://detail.1688.com/offer/0000000000000.html",
  "main_image": "https://cbu01.alicdn.com/img/ibank/<...>.jpg",
  "price_cny": "42.00",
  "quantity_prices": [{"quantity": "≥1件", "value": "42.00"}],
  "shop_name": "Example Trading Co., Ltd.",
  "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"
}

See the dataset default view for all product fields.

---

📊 Current status

Success rate when collecting from 1688 varies over time. Searching a single keyword in isolation may occasionally return 0 results for that run.

For more complete results:

• Submit 3-5 keywords per run — multi-keyword runs are more likely to return complete results overall
• If several runs in a row return 0, wait ~30 minutes before retrying — retries after a cooldown are typically more stable
• If a run still returns 0, the OUTPUT lists failed_keywords so you can retry only the affected ones later

---

💡 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 may not return results for a specific keyword at a given moment. See the "📊 Current status" section above for handling tips; the OUTPUT's failed_keywords field lists which keywords were affected so you can retry only those later.

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 put my 1688 account or IP at risk?

No. This Actor runs entirely anonymously — no login, no account credentials attached. Outbound connections go through anonymous proxy exits, so neither your personal IP nor your 1688 account is ever used or exposed. If you occasionally encounter platform-side restrictions, that's a platform-level rule affecting that time window, not anything specific to you.

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.