This tool extracts structured product and seller data directly from 1688.com, enabling fast and reliable access to key e-commerce insights. It simplifies large-scale data collection from complex pages and delivers clean outputs ready for analysis or automation workflows.
Created by Bitbash, built to showcase our approach to Scraping and Automation!
If you are looking for cn-1688-scraper you've just found your team — Let’s Chat. 👆👆
The CN 1688 Scraper retrieves product, pricing, seller, and metadata from 1688.com with high consistency. It solves the challenge of gathering structured Chinese marketplace information that is typically locked behind dynamic interfaces. Ideal for data analysts, sourcing agents, automation engineers, and e-commerce researchers.
- Helps source products efficiently from Chinese wholesale suppliers.
- Supports pricing analysis and competitive benchmarking.
- Enables automation for product research and catalog creation.
- Reduces manual lookup time and errors.
- Powers data-driven ecommerce decisions.
| Feature | Description |
|---|---|
| Dynamic content handling | Captures product data rendered by JavaScript-rich pages. |
| Seller information extraction | Retrieves shop details, ratings, and contact information. |
| Product metadata parsing | Extracts images, variations, specs, and pricing blocks. |
| Supports keyword & URL-based runs | Flexible input modes for both targeted and broad data collection. |
| Scalable architecture | Handles multiple pages efficiently with queue-based crawling. |
| Field Name | Field Description |
|---|---|
| product_title | Main name/title of the product listing. |
| product_url | Direct URL to the 1688 product page. |
| price | Listed product price or price range. |
| min_order | Minimum order quantity required by the seller. |
| seller_name | Supplier or store name on 1688. |
| seller_url | Direct link to the seller/shop profile. |
| images | Array of product image URLs. |
| description | Long-form product description or specifications. |
[
{
"product_title": "High-Quality Phone Case",
"product_url": "https://detail.1688.com/example",
"price": "¥3.20 - ¥5.00",
"min_order": "10 pieces",
"seller_name": "Shenzhen Mobile Accessories Co.",
"seller_url": "https://shop.1688.com/example",
"images": [
"https://cbu01.alicdn.com/img1.jpg",
"https://cbu01.alicdn.com/img2.jpg"
],
"description": "Durable shockproof phone case suitable for multiple models."
}
]
CN 1688 Scraper/
├── src/
│ ├── main.js
│ ├── crawler/
│ │ ├── playwrightClient.js
│ │ └── pageHandlers.js
│ ├── extractors/
│ │ ├── productParser.js
│ │ └── sellerParser.js
│ ├── utils/
│ │ ├── logger.js
│ │ └── formatters.js
│ └── config/
│ └── settings.json
├── data/
│ ├── sample-input.json
│ └── sample-output.json
├── package.json
├── requirements.txt
└── README.md
- E-commerce sellers use it to gather product data for catalog creation, improving sourcing decisions.
- Market analysts use it to analyze pricing trends and supplier competition.
- Automation teams integrate it into pipelines to enrich product databases at scale.
- Sourcing agencies retrieve supplier info to vet manufacturers quickly.
- Data teams utilize structured outputs for dashboards, ML models, or forecasting tools.
Q: Does the scraper handle dynamic content on 1688.com? Yes, it processes JavaScript-rendered product pages to ensure complete extraction.
Q: Can it extract multiple products at once? You can collect data from many listings by providing keywords or lists of URLs.
Q: Does it support specification and variation parsing? Yes, product details such as sizes, colors, and technical specs are extracted when available.
Q: Can the scraper run at scale? The architecture supports batch operations and queue-based crawling for large datasets.
Primary Metric: Processes an average of 12–18 product pages per minute depending on page complexity.
Reliability Metric: Achieves a 96%+ successful extraction rate across thousands of runs.
Efficiency Metric: Optimized resource consumption with minimal browser restarts during long crawls.
Quality Metric: Consistently captures over 90% of visible product metadata including images, descriptions, and seller details.
