1688.com Scraper
Pricing
from $2.40 / 1,000 product scrapeds
1688.com Scraper
Search 1688.com wholesale products by keyword, up to 2,000 per search with no login, or collect product URLs. Export prices, sales, price tiers, MOQ, supplier ratings, province and city. Sort by sales or price; filter by price and province.
Pricing
from $2.40 / 1,000 product scrapeds
Rating
3.0
(1)
Developer
Automation Lab
Maintained by CommunityActor stats
0
Bookmarked
170
Total users
16
Monthly active users
5 days ago
Last modified
Categories
Features
Share
1688.com Scraper — B2B Wholesale Product Extractor
What does it do?
This actor scrapes 1688.com — Alibaba's B2B domestic marketplace and China's largest wholesale platform. Search listings by keyword, or submit saved product URLs / offer IDs to collect sourcing-grade details such as MOQ, every quantity-price tier, gallery images, attributes, supplier, and dispatch location.
The two additive input modes are:
- Keyword search: pages through 1688.com's own search results, up to 2,000 products per keyword with no login. Each row has the price, sales, supplier with ratings, membership years, province and city, and price tiers where shown. Sort by best selling or price, and filter by price range, supplier province or sponsored listings.
- Product details: one enriched row per unique
productUrlsoffer. This mode uses 1688.com's public mobile product surface through the configured proxy and does not require account cookies.
Available fields include:
- 💰 Factory-direct prices in CNY + USD equivalent
- 📦 MOQ & tiered bulk pricing — see price breaks at different volumes
- 🏭 Supplier information — name, location, performance scores
- 📊 Demand metrics — order count and repurchase rate
- 🏅 Supplier quality scores — logistics, goods quality, dispute resolution
Who is it for?
🚀 Dropshippers & Product Sourcers
Find products at factory-direct prices (typically 30–60% lower than Alibaba international). Validate demand with real order counts before placing bulk orders.
📦 Amazon FBA Sellers
Identify high-potential products by filtering for items with 500+ orders. Compare factory prices against Amazon selling prices to calculate exact margins before sourcing.
🔍 Competitive Intelligence Analysts
Monitor competitor product catalogs, track price changes over time, and identify trending categories in the Chinese wholesale market.
💼 B2B Procurement Teams
Automate supplier discovery. Search for specific product types, filter by supplier quality scores, and build a shortlist of pre-vetted manufacturers.
📈 E-commerce Entrepreneurs & AI Developers
Build product databases, train price prediction models, or feed AI pipelines with real wholesale pricing data from China's largest B2B platform.
Why use this scraper?
- ✅ Extracts data competitors don't — tiered bulk pricing tiers, supplier score breakdowns, repurchase rates
- ✅ Fresh data — scrapes live 1688.com listings, not cached datasets
- ✅ Structured output — clean JSON/CSV ready for spreadsheets or databases
- ✅ Numeric fields — prices as numbers (not strings), scores as decimals
- ✅ No login needed — up to 2,000 products per keyword from 1688.com's own search, with sort and filters
- ✅ Multi-keyword support — run multiple product searches in a single job
- ✅ Direct offer collection — pass product URLs or numeric offer IDs for MOQ, full price ladders, images, attributes, and service terms
What data does it extract?
| Field | Description | Example |
|---|---|---|
productId | 1688 listing ID | 549929725456 |
title | Product title (Chinese) | TWS无线蓝牙耳机5.0 |
url | Direct product URL | https://detail.1688.com/offer/... |
thumbnailUrl | Main product image | https://cbu01.alicdn.com/... |
imageUrls | Full product gallery for product URLs; the main image for keyword search | ["https://cbu01.alicdn.com/..."] |
priceCny | Price in CNY (numeric) | 28.50 |
priceUsd | Approx USD price | 3.93 |
moq | Minimum order quantity (detail mode) | 10 |
unit | Seller's order unit (detail mode) | 个 |
currency | Always "CNY" | CNY |
supplierName | Factory/supplier name | 深圳市XX电子有限公司 |
supplierId | Seller member ID | b2b-2582465574 |
supplierUrl | Supplier storefront URL | https://shop1234.1688.com |
supplierYears | Years as a paid 1688 member (诚信通), keyword search | 6 |
businessType | Supplier business type, keyword search (生产加工 = manufacturer) | 生产加工 |
location | Seller dispatch location (detail mode) | 广东深圳 |
province | Province (Chinese) | 广东 |
city | City (Chinese) | 深圳市 |
orderCount | Total orders placed. Anonymous searches read a rounded sales label, so 700+ becomes 700 and 10万+ becomes 100000 | 2547 |
repurchaseRate | Customer repurchase % | 18% |
compositeScore | Overall supplier rating (0–5) | 4.2 |
logisticsScore | Shipping performance (0–5) | 4.5 |
goodsScore | Product quality rating (0–5) | 4.0 |
disputeScore | Dispute resolution (0–5) | 4.3 |
consultationScore | Customer service (0–5) | 4.1 |
returnScore | Return processing (0–5) | 4.4 |
quantityPrices | Complete seller quantity-price ladder (detail mode) | [{quantity: "1-99", priceCny: 28.5}] |
attributes | Seller-provided product specifications (detail mode) | [{name: "材质", value: "亚克力"}] |
serviceTags | Service terms (Chinese) | ["退货包运费", "先采后付"] |
productBadges | Supplier badges: super_factory, factory_inspected, business_inspected, and sponsored for ads | ["factory_inspected"] |
isAd | True for a paid placement in search results | false |
searchKeyword | Search term, or null for direct detail inputs | "phone case" |
scrapedAt | ISO 8601 timestamp | 2026-04-01T12:00:00Z |
Field availability by mode
Keyword rows carry what 1688.com's search results show: product, URL, image, price, supplier with ID, storefront, ratings and membership years, business type, province, city and service tags. Sales counts, repurchase rate, MOQ and the price ladder appear only when 1688.com shows them on the result card, so new listings often have them empty. Direct productUrls rows are the sourcing-detail mode: they add the full MOQ, the seller's quantity-price ladder, gallery images, attributes and dispatch location; supplier ratings stay empty there because the product page does not publish them. Unknown values are null, never 0.
💰 How much does it cost to scrape 1688.com products?
This actor uses Pay Per Event (PPE) pricing — you only pay for what you scrape:
| Event | FREE Plan | BRONZE | SILVER | GOLD | PLATINUM | DIAMOND |
|---|---|---|---|---|---|---|
| Run start | $0.020 | $0.019 | $0.017 | $0.015 | $0.012 | $0.010 |
| Per product | $0.0040 | $0.0036 | $0.0030 | $0.0024 | $0.0016 | $0.0011 |
From 2026-11-26 the price will be: run start $0.019 on every plan; per product $0.0036 on FREE and BRONZE, $0.00324 on SILVER, and $0.00288 on GOLD, PLATINUM and DIAMOND.
Example costs:
- Scrape 50 products: ~$0.22 (FREE tier)
- Scrape 200 products: ~$0.82
- Scrape 1,000 products: ~$4.02
Free trial: New Apify accounts include a $5 free credit — enough to scrape 1,000+ products.
Tip: Use Apify's subscription plans for volume discounts (up to 72% off at DIAMOND tier).
How to scrape 1688.com products
Step 1: Open the actor
Go to 1688.com Scraper on Apify Store.
Step 2: Choose an input mode
For discovery, enter Chinese or English keywords such as 手机壳 or bluetooth earbuds. For specific products, paste one or more 1688 offer URLs or numeric IDs into productUrls. You can combine both modes in one run. A completely empty input retains the useful 手机壳 keyword default.
{"productUrls": ["https://detail.1688.com/offer/711729262606.html","943456237066"]}
Duplicate references to the same offer are collected and charged only once. Non-1688 URLs and malformed IDs fail input validation before scraping.
Step 3: Set max results
Set maxResults to control how many products to collect per keyword, up to 2,000 (1688.com shows at most 2,000 matches per search). Default is 48.
Step 4: Choose sort order and filters (optional)
- Best Selling (default) — finds proven products with high demand
- Price: Low to High / High to Low — cheapest or premium factory prices first
- Default — 1688.com's relevance order
Narrow the search with priceMin / priceMax (CNY), province (in Chinese, such as 广东 or 浙江), and excludeAds to leave out sponsored listings. Filters apply to keyword search only.
No login or cookies are needed. The optional Session Cookies field is only a fallback if 1688.com's search API stops answering.
Step 5: Run and export
Click "Start" and wait for results. Export to JSON, CSV, or Excel from the Results tab.
Input parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
keywords | array | empty input uses ["手机壳"] | Optional search keywords (Chinese or English) |
productUrls | array | optional | 1688 product URLs or numeric offer IDs for detail collection |
maxResults | integer | 48 | Max products per keyword (up to 2,000) |
sortType | string | bestSelling | default, bestSelling, priceLow, priceHigh |
priceMin | integer | optional | Minimum price in CNY (keyword search) |
priceMax | integer | optional | Maximum price in CNY (keyword search) |
province | string | optional | Supplier province in Chinese, such as 广东 (keyword search) |
excludeAds | boolean | false | Leave out sponsored listings |
cookies | string | optional | Not needed. Logged-in cookies, used only as a fallback browser search if the search API stops answering |
proxyConfiguration | object | CN residential | Used by product-detail collection and the fallback browser search; keyword search picks its own Apify Proxy |
Sort type options
| Sort Type | Value | Best for |
|---|---|---|
| Best Selling | bestSelling | Finding proven high-demand products |
| Price Low | priceLow | Finding cheapest factory prices |
| Price High | priceHigh | Premium/high-value products |
| Default | default | Relevance-based results |
Output example
{"productId": "549929725456","title": "TWS无线蓝牙耳机5.0降噪运动","url": "https://detail.1688.com/offer/549929725456.html","thumbnailUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01.../image.jpg","imageUrls": ["https://cbu01.alicdn.com/img/ibank/O1CN01.../image.jpg","https://cbu01.alicdn.com/img/ibank/O1CN02.../image.jpg"],"priceCny": 28.50,"priceUsd": 3.93,"moq": 10,"unit": "个","currency": "CNY","supplierName": "深圳市鸿达电子科技有限公司","supplierId": "b2b-2582465574fd1bb","supplierUrl": "https://shop1234.1688.com","supplierYears": 6,"businessType": "生产加工","location": "广东深圳","province": "广东","city": "深圳市","orderCount": 2547,"repurchaseRate": "18%","compositeScore": 4.2,"logisticsScore": 4.5,"goodsScore": 4.0,"disputeScore": 4.3,"consultationScore": 4.1,"returnScore": 4.4,"quantityPrices": [{ "quantity": "1~99件", "minQty": 1, "priceCny": 28.50, "priceUsd": 3.93 },{ "quantity": "100~499件", "minQty": 100, "priceCny": 24.00, "priceUsd": 3.31 },{ "quantity": "≥500件", "minQty": 500, "priceCny": 19.50, "priceUsd": 2.69 }],"attributes": [{ "name": "材质", "value": "亚克力" },{ "name": "品牌", "value": "示例品牌" }],"serviceTags": ["退货包运费", "先采后付"],"productBadges": ["factory_inspected"],"isAd": false,"searchKeyword": "蓝牙耳机","scrapedAt": "2026-04-01T12:34:56.789Z"}
Tips for best results
🔍 Search tips
- Use Chinese keywords for more results (1688 is a Chinese-language platform)
- Combine searches:
["手机壳", "phone case"]gets overlapping results for more coverage - Broad keywords work best:
耳机(earphones) vs a specific model number
📊 Finding winning products
- Use
sortType: "bestSelling"to find proven sellers - Filter for
orderCount >= 500— high orders = proven demand - Check
repurchaseRate— 10%+ indicates satisfied customers - Verify
compositeScore >= 4.0for reliable suppliers
🏭 Evaluating suppliers
compositeScore 4.0–5.0= Excellent (recommended)compositeScore 3.0–3.9= Good (proceed with caution)compositeScore < 3.0= Below average (higher risk)logisticsScore= Shipping reliabilitygoodsScore= Product quality consistency
💰 Calculating margins
Use quantityPrices to find your break-even MOQ. Example:
- 1–99 units: ¥28.50 ($3.93) each
- 100+ units: ¥24.00 ($3.31) each — 15% discount for bulk
- 500+ units: ¥19.50 ($2.69) each — 31% bulk discount
⚙️ Service tags reference (Chinese → English)
退货包运费= Free return shipping先采后付= Buy now, pay later7天无理由退货= 7-day no-reason returns假一赔四= Counterfeit product 4x refund guarantee
Integrations
🤖 AI/LLM sourcing pipeline
Feed 1688.com data into an AI system to automate product research:
1688 Scraper → GPT-4 analyzer → Supplier shortlist → Order automation
📊 Price monitoring workflow
Schedule daily runs to track wholesale price changes:
1688 Scraper (daily) → Database → Price alert when > 10% change
🔗 Apify integrations
Connect to 500+ apps via Apify integrations:
- Google Sheets — auto-update a product research spreadsheet
- Zapier/Make — trigger downstream workflows
- Slack — notify your team when new products meet criteria
- Airtable — build a sourcing CRM with supplier contacts
API usage
Node.js
const { ApifyClient } = require('apify-client');const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });const run = await client.actor('automation-lab/1688-scraper').call({productUrls: ['https://detail.1688.com/offer/711729262606.html','943456237066',],});const { items } = await client.dataset(run.defaultDatasetId).listItems();console.log(`Scraped ${items.length} products`);
Python
from apify_client import ApifyClientclient = ApifyClient('YOUR_API_TOKEN')run = client.actor('automation-lab/1688-scraper').call(run_input={'keywords': ['phone case', 'bluetooth earbuds'],'maxResults': 100,'sortType': 'bestSelling',})items = client.dataset(run['defaultDatasetId']).list_items().itemsprint(f"Scraped {len(items)} products")for item in items[:3]:print(f"{item['title']} — ¥{item['priceCny']} | Orders: {item['orderCount']}")
cURL
curl -X POST "https://api.apify.com/v2/acts/automation-lab~1688-scraper/runs?token=YOUR_TOKEN" \-H "Content-Type: application/json" \-d '{"keywords": ["phone case"],"maxResults": 50,"sortType": "bestSelling"}'
Use with Claude (MCP)
Connect this actor to Claude via the Model Context Protocol (MCP) to research 1688.com products conversationally.
Claude Code setup
$claude mcp add --transport http apify https://mcp.apify.com?tools=automation-lab/1688-scraper
Claude Desktop / VS Code / Cursor setup
Add to your MCP config (Claude Desktop on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
{"mcpServers": {"apify": {"type": "http","url": "https://mcp.apify.com?tools=automation-lab/1688-scraper","headers": {"Authorization": "Bearer YOUR_APIFY_TOKEN"}}}}
Example prompts for Claude
Once connected, you can ask Claude:
"Find the top 20 best-selling phone accessories on 1688.com with prices under ¥50 and at least 500 orders"
"Search 1688.com for 'led strip lights' and summarize the price range, MOQ, and which provinces the suppliers are from"
"Compare 50 bluetooth earbuds on 1688.com — which have composite scores above 4.0 and what are their prices?"
"Find 30 products in the 'portable charger' category and calculate potential Amazon FBA margins assuming 3x markup"
Diagnostics and data handling
Failed operations send sanitized diagnostic input, exceptions and Actor, build and run IDs to our private GlitchTip service so we can repair faults. Secret fields such as session cookies and URL queries are removed, and reports are retained for 30 days.
Legality: is scraping 1688.com legal?
Web scraping publicly accessible product listings for personal use, research, and non-commercial purposes is generally considered legal in most jurisdictions. This actor scrapes publicly accessible product data (no private data, no user accounts accessed beyond your own session).
Important:
- 1688.com's Terms of Service may restrict automated access. Review their ToS before large-scale use.
- This actor does not scrape personal information, messages, or account data.
- Data is intended for research and business intelligence — not for republishing competitor supplier lists or for spamming.
- Apify's Responsible Data Collection Policy applies.
FAQ
Q: Does this actor require a 1688.com account? A: No. Keyword search and product URLs both work without an account or cookies.
Q: Why are titles in Chinese? A: 1688.com is a Chinese-language platform. All product titles, service tags, and location data are in Simplified Chinese. You can use a translation API to convert them.
Q: What currency are prices in?
A: Prices are extracted in CNY (Chinese Yuan). The priceUsd field provides an approximate USD equivalent using a fixed rate (~0.138 USD/CNY). Verify current rates before financial decisions.
Q: The actor returned 0 results for my keyword. Why? A: This can happen when:
- The keyword has no results on 1688.com (try a broader term or Chinese equivalent)
- 1688.com refused the request several times in a row (the run then fails and says so; retry after a few minutes)
- A transient network or upstream response issue — retry once after a few minutes
Q: Can I scrape product detail pages for more data?
A: Yes. Add 1688 offer URLs or numeric IDs to productUrls. Detail rows include MOQ, the complete quantity-price ladder shown by the seller, gallery images, attributes, supplier, dispatch location, and service terms when available. searchKeyword is null for these direct inputs.
Q: How many results can I get per keyword?
A: Up to 2,000, the most 1688.com shows for one search (34 pages of 60). Sponsored listings appear where 1688.com places them, with isAd: true; set excludeAds to leave them out. If the search API ever fails before any row is saved, the run falls back to 1688.com's public market page, which shows 60 listings per keyword, and the status message says so.
Q: Do I need a Chinese proxy? A: No. Keyword search picks its own Apify Proxy. The CN residential proxy setting is used for product URLs and the optional cookie fallback.
Related scrapers
- Alibaba.com Scraper — International wholesale listings
- AliExpress Scraper — Consumer-facing retail prices
- Temu Scraper — Cross-border e-commerce platform
- Amazon Product Scraper — Calculate FBA margins from source to sale
- Amazon Reviews Scraper — Validate product demand with buyer feedback