# 1688.com Wholesale & Factory Scraper (阿里巴巴批发网) 🇨🇳 (`scraperpro/1688-wholesale-scraper`) Actor

Ultra-fast, cost-effective 1688.com wholesale scraper. Extracts B2B tiered wholesale pricing, MOQ, SKU matrices, factory/supplier intelligence, repurchase rates, and HD media with Pay-Per-Event pricing.

- **URL**: https://apify.com/scraperpro/1688-wholesale-scraper.md
- **Developed by:** [ScraperPro](https://apify.com/scraperpro) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.90 / 1,000 search product listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 1688 Wholesale & Factory Scraper (阿里巴巴批发网) 🇨🇳🏭

The most advanced **1688 product scraper** and **supplier intelligence tool** for cross-border e-commerce sellers, Amazon FBA merchants, Shopify store owners, dropshippers, and global procurement teams. Extract direct factory prices, bulk volume discount tiers, minimum order quantities (MOQ), complete color/size variation matrices with photos, Amazon FBA packaging weights, and verified manufacturer badges — directly into **Excel**, **CSV**, or **Google Sheets** with zero coding required.

Whether you are finding genuine Chinese manufacturers on **1688.com (Alibaba)**, calculating exact landed product costs, or empowering autonomous AI sourcing agents, this tool automates your entire China factory procurement workflow.

***

### 🏆 Why Sourcing Teams Choose This Scraper

Most scrapers only extract a basic product title and a single flat price. This tool was custom-built for **professional importers, procurement managers, and e-commerce buyers** who need actionable factory data:

- **Direct Factory Bulk Pricing**: View the exact tiered volume discount brackets (e.g., 2–99 pcs, 100–499 pcs, 500+ pcs) that Chinese domestic distributors receive.
- **Exclusive FBA Packaging Weights & Dimensions**: Accurately calculate air freight, sea shipping, and Amazon FBA fulfillment fees using physical unit weights (in grams) and package dimensions per SKU.
- **Full Variant & Spec Matrix with Matching Photos**: Capture every SKU option (all colors, sizes, and configurations) along with individual variant pricing, warehouse stock count, and high-resolution spec photos.
- **Verified Manufacturer Badges**: Cut out middlemen and trading companies by filtering directly for Alibaba-certified **Super Factories (超级工厂)** and plants with third-party on-site audits (**深度验厂**).
- **Logistics & Fulfillment SLA**: Check the factory's dispatch location, 48-hour delivery commitment, and buyer protection policies before ordering samples.
- **Customer Repurchase Trust Metric**: Use real customer **Repurchase Rates (回头率)** to instantly separate top-tier manufacturers from poor-quality suppliers.
- **Dedicated Wholesale Sourcing Channels**: Query specialized 1688 channels at the source: Direct Factory (`找工厂` for OEM/ODM), Super Factory (`超级工厂` for top certified mega-plants), Cross-Border Export (`跨境专供` for Amazon FBA / Temu / TikTok sellers), or Ready-to-Ship Spot Market (`现货批发`).
- **1-Click Spreadsheet Download**: Run directly in your browser and export clean, structured datasets in Microsoft Excel, CSV, or Google Sheets.

***

### 🥊 How It Compares to Other 1688 Scrapers

| Sourcing Capability | This Scraper (Pro) | Other 1688 Scrapers | Generic Web Scrapers |
| :--- | :---: | :---: | :---: |
| **Pricing Model** | **Pay-Per-Event (Only pay for results)** | Monthly rentals or expensive add-ons | Expensive compute hours ($0.40/CU) |
| **Fast Discovery (Summary Mode)** | ✅ **50% Lower Cost for Rapid Scanning** | ❌ Flat high rate only | ❌ Unpredictable compute costs |
| **Wholesale Sourcing Channels** | ✅ **Direct Factory, Super Factory, Cross-Border Export, Spot** | ❌ General keyword search only | ❌ None |
| **Tiered Volume Price Matrix** | ✅ **Full Multi-Bracket Volume Tiers** | ❌ Single starting price only | ❌ Usually missing |
| **Amazon FBA Packaging Weights** | ✅ **Exact Grams & Dimensions per SKU** | ❌ Not available | ❌ Not available |
| **Complete SKU Matrix + Variant Photos** | ✅ **All Variations, Stock & Photos** | ⚠️ Text only or incomplete | ❌ Missing variant stock |
| **Factory Due Diligence Badges** | ✅ **Included Free (Super Factory, 深度验厂, 回头率)** | ⚠️ Charged as separate paid add-on | ❌ Missing |
| **Start URLs Versatility** | ✅ **Product Links, Offer IDs & Filtered Search URLs** | ⚠️ Product links only | ⚠️ Unreliable |
| **Chinese Character URL Decoding** | ✅ **Automatic GBK & UTF-8 URL Decoding** | ❌ Corrupts GBK query strings | ❌ None |
| **Export Formats** | ✅ **Excel (.xlsx), CSV, Google Sheets, JSON** | ⚠️ JSON / CSV only | ⚠️ Raw unstructured HTML |

***

### 💼 Real-World Use Cases

#### 1. 📦 Amazon FBA Private Label Sourcing

- **Calculate Landed Cost Accurately**: Use the extracted unit packaging weight (grams) and dimensions alongside bulk volume pricing tiers to accurately calculate international freight shipping and FBA fulfillment fees before ordering.
- **Find High-Volume B2B Suppliers**: Filter by total warehouse inventory and verify that manufacturers have the capacity to scale with your sales velocity.

#### 2. 🛍️ Shopify, TikTok Shop & Dropshipping Product Research

- **Discover Viral Best-Sellers**: Search hot trending niches and sort by sales volume (Booked Orders) to find proven winning products.
- **Enrich Store Product Catalogs**: Download complete SKU variant matrices, high-resolution product galleries, and demonstration video URLs ready to upload to Shopify or WooCommerce.
- **Identify 48-Hour Fast Dispatch Suppliers**: Filter suppliers by dispatch city and fast shipping SLA guarantees to reduce customer fulfillment delivery times.

#### 3. 🏭 Direct Factory Procurement & Supply Chain Auditing

- **Cut Out Trading Agents & Middlemen**: Filter strictly for **Super Factories (超级工厂)** and facilities with verified **SGS / BV third-party on-site audits (深度验厂)**.
- **Negotiate Better Contract Rates**: Inspect the manufacturer's real domestic volume discounts to gain immediate leverage during price negotiations.

#### 4. 📈 Competitor Price Monitoring & Wholesale Arbitrage

- **Benchmark Supplier Costs**: Monitor pricing fluctuations, seasonal promotions, and minimum order requirements across competing Chinese factories.
- **Find Alternative Backup Suppliers**: Quickly compile directory lists of secondary manufacturers in adjacent industrial clusters (e.g. Guangdong vs. Zhejiang).

#### 5. 🏪 Yiwu Market Small Commodities Sourcing

- **Dollar Store & Novelty Sourcing**: Target Zhejiang and Yiwu wholesale markets directly to source impulse-buy novelties, stationery, home organizers, and party supplies at fraction-of-a-cent factory rates.

***

### 🏭 Specialized 1688 Wholesale Sourcing Channels

Unlike generic scrapers that only query general search, this Actor allows you to target 1688's dedicated wholesale channels directly at the source:

1. **Direct Factory (`找工厂` / OEM & ODM)**:
   - Queries verified manufacturing facilities specializing in custom tooling, private-label branding, and contract production. Automatically filters out trading companies and commission agents so you negotiate directly with plant managers.
2. **Super Factory (`超级工厂` / Mega-Plants)**:
   - Restricts results to Alibaba's elite certified tier of Chinese mega-manufacturers with audited plant sizes, modern production lines, and high annual turnover.
3. **Cross-Border Export (`跨境专供` / Amazon FBA, Temu & TikTok Shop)**:
   - Sourced specifically for global exporters. These factories specialize in Western retail packaging, English spec sheets, CE/FCC/RoHS compliance, and express dispatch to port warehouses.
4. **Ready-to-Ship Spot Market (`现货批发`)**:
   - Live in-stock warehouse inventory ready to dispatch within 24 to 48 hours. Perfect for small sample test orders, fast turns, and dropshipping.
5. **All Channels (`全网综合`)**:
   - Comprehensive sitewide marketplace search across all 1688 suppliers.

> \[!TIP]
> **AI & Autonomous Agents**: This Actor natively supports Claude, Cursor, Windsurf, and custom AI agents via the **API & Integrations** and **MCP Server** tabs above. Clean, typed schemas with physical weights, tiered pricing, and supplier audit metrics allow AI agents to perform automated procurement due diligence out of the box.

***

### 📥 Sample Input Configurations

#### Example 1: Search by Keyword with Super Factory Filters

Search for verified phone case manufacturers located in Guangdong province, sorted by sales volume:

```json
{
  "keyword": "phone case",
  "detailLevel": "full",
  "maxItems": 50,
  "sortBy": "booked",
  "province": "广东",
  "superFactoryOnly": true,
  "factoryInspectionOnly": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
```

#### Example 2: Start URLs (Direct Products or Search Listing URLs)

Paste direct product links, numeric offer IDs, or search listing URLs copied straight from your browser. The scraper automatically routes them:

```json
{
  "startUrls": [
    "https://detail.1688.com/offer/685176373959.html",
    "https://s.1688.com/selloffer/offer_search.htm?keywords=hoodie",
    "610947572343"
  ],
  "maxItems": 30,
  "detailLevel": "full",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
```

#### Example 3: Budget Sourcing with Price Caps (Yiwu Market)

Find budget kitchen tools under ¥15 CNY from Zhejiang province:

```json
{
  "keyword": "kitchen gadgets",
  "detailLevel": "summary",
  "maxItems": 100,
  "sortBy": "priceAsc",
  "priceMin": 1,
  "priceMax": 15,
  "province": "浙江",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
```

***

### 📤 Sample Output Data

Here is an example of a complete B2B wholesale product record extracted in **Full Detail** mode:

```json
{
  "id": "685176373959",
  "offerId": "685176373959",
  "url": "https://detail.1688.com/offer/685176373959.html",
  "title": "适用苹果x手机壳iPhoneX保护套iponex新款ipx液态硅胶ix外壳纯色",
  "price": 1.8,
  "currency": "CNY",
  "priceDisplay": "1.40 - 1.80",
  "minOrderQuantity": 1,
  "totalStock": 43557,
  "salesVolume": "已售10万+件",
  "repurchaseRate": "38.5%",
  "superFactory": true,
  "factoryInspection": true,
  "tieredPrices": [
    { "minQuantity": 1, "maxQuantity": 499, "price": 1.8, "unit": "件" },
    { "minQuantity": 500, "maxQuantity": 999, "price": 1.6, "unit": "件" },
    { "minQuantity": 1000, "maxQuantity": null, "price": 1.4, "unit": "件" }
  ],
  "pictureUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01TfAMgq2KExhpOwxbE_!!2214687799526-0-cib.jpg",
  "images": [
    "https://cbu01.alicdn.com/img/ibank/O1CN01TfAMgq2KExhpOwxbE_!!2214687799526-0-cib.jpg",
    "https://cbu01.alicdn.com/img/ibank/O1CN01NhwImi2KExhrALHsS_!!2214687799526-0-cib.jpg",
    "https://cbu01.alicdn.com/img/ibank/O1CN01KQOkGh2KExhvxorp2_!!2214687799526-0-cib.jpg"
  ],
  "videoUrl": null,
  "skuMatrix": [
    {
      "skuId": "5066775858930",
      "specId": "5405c1ade1d9d2e9ba0c2ad101623132",
      "variant": "苹果X-XS【草紫色】",
      "price": 1.8,
      "stock": 4967,
      "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01cn9PGM2KExhk07FyO_!!2214687799526-0-cib.jpg"
    },
    {
      "skuId": "4893701804460",
      "specId": "2b4174c3e987a9eca9a9c741f3c495ad",
      "variant": "苹果X-XS【石墨黑】",
      "price": 1.8,
      "stock": 4389,
      "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01juMWTc2KExhpOvLom_!!2214687799526-0-cib.jpg"
    }
  ],
  "packaging": [
    {
      "skuId": "4893701804460",
      "variant": "苹果X-XS【石墨黑】",
      "weightGrams": 30.0,
      "lengthCm": 15.0,
      "widthCm": 8.0,
      "heightCm": 1.2,
      "volumeCm3": 144.0
    }
  ],
  "shipping": {
    "dispatchLocation": "广东省汕头市",
    "deliveryPromise": "承诺48小时发货",
    "dispatchTime": "预计2小时发货",
    "shippingFee": 0.0,
    "isFreeShipping": true,
    "services": ["品质不符包赔", "7天无理由退货", "严选晚发必赔"]
  },
  "supplier": {
    "companyName": "东莞市虎门清运货运代理服务部",
    "name": "东莞市虎门清运货运代理服务部",
    "loginId": "优选手机配件",
    "memberId": "b2b-221468779952686089",
    "shopUrl": "https://winport.m.1688.com/page/index.html?memberId=b2b-221468779952686089",
    "city": "东莞市",
    "province": "广东省",
    "trustPass": true,
    "powerfulMerchant": false
  },
  "sevenDayTrafficUV": 1250,
  "specs": {
    "材质": "液态硅胶",
    "工艺": "磨砂手感",
    "款式": "全包防摔保护壳",
    "品牌": "中性",
    "功能": "防摔/抗震",
    "适用机型": "Apple/苹果"
  },
  "categoryPath": ["手机配件", "手机保护套"],
  "detailLevel": "full",
  "scrapedAt": "2026-09-17T12:15:00Z"
}
```

***

### 📖 Output Field Dictionary

| Field Name | Type | Description | Sourcing Importance |
| :--- | :--- | :--- | :--- |
| `offerId` | String | Unique numeric identifier for the 1688 product | Permanent reference for re-scraping and supplier messaging |
| `title` | String | Original product headline on 1688 | Contains manufacturer keywords and model compatibility |
| `price` | Number | Base unit wholesale price in CNY (¥) | Starting benchmark price |
| `priceDisplay` | String | Full price range across variants and quantities (e.g. `1.40 - 1.80`) | Shows price span between single units and bulk volume |
| `minOrderQuantity` | Number | Minimum Order Quantity (MOQ) | Informs whether small test batches are accepted |
| `totalStock` | Number | Total units currently available across all variants | Informs warehouse scale and inventory health |
| `tieredPrices` | Array | Full quantity-break discount matrix (`minQuantity`, `maxQuantity`, `price`) | Exact bulk purchase price brackets |
| `skuMatrix` | Array | Complete variant breakdown with Spec IDs, variant names, individual prices, inventory, and matching photos | Shows all available colors, sizes, and specific stock counts |
| `packaging` | Array | Physical weight in grams (`weightGrams`) and dimensions (`lengthCm`, `widthCm`, `heightCm`, `volumeCm3`) | Essential for Amazon FBA fee tiers and international shipping calculations |
| `shipping` | Object | Dispatch location, 48-hour fulfillment guarantee, shipping fee, free shipping flag | Sourcing logistics and delivery speed verification |
| `superFactory` | Boolean | True if the manufacturer is an Alibaba-verified **Super Factory (超级工厂)** | Verifies large-scale production capacity and audited facilities |
| `factoryInspection` | Boolean | True if audited on-site by third-party inspection agencies (**深度验厂**) | SGS / BV audited manufacturing plant verification |
| `repurchaseRate` | String | Percentage of repeat buyers (**回头率**) | Above 30%–40% indicates dependable product quality |
| `supplier` | Object | Company name, official shop URL, member ID, city, province, and TrustPass status | Enterprise registration and vendor background verification |
| `images` | Array | High-resolution product photo gallery URLs | Ready to use for e-commerce listings and catalogs |
| `videoUrl` | String | Product demonstration video stream URL (or null) | Ready for TikTok, Instagram Reels, and product pages |

***

### 🚀 How to Use (Step-by-Step, No Code Required)

1. **Enter Your Keyword or Product Links**: Type any product keyword in English or Chinese (e.g. `wireless earbuds`, `yoga pants`, `hoodie`, `phone case`) or paste specific 1688 product URLs.
2. **Choose Your Sourcing Level**:
   - **Full Detail**: Extracts complete bulk pricing tiers, all color/size variations with photos, Amazon FBA packaging weights, and factory verification badges.
   - **Fast Search Summary**: Quickly scans search result cards (title, price, photo, supplier name) to find top trending products.
3. **Select Your Filters (Optional)**:
   - Target specific manufacturing clusters (e.g. **Guangdong** for electronics, **Zhejiang** for small commodities).
   - Check **Super Factory Only** to filter out middlemen and trading agents.
   - Set minimum and maximum wholesale price limits.
4. **Click "Start" & Download Your Spreadsheet**: Once the run completes, click **Export** to download your complete data file in **Excel (.xlsx)**, **CSV**, or sync it to **Google Sheets**.

***

### 💰 Transparent Pay-Per-Event (PPE) Pricing

This scraper operates on Apify's transparent **Pay-Per-Event** billing model:

- **Zero Idle Fees**: You never pay for startup delays, cold boots, or idle server time.
- **Pay Only for What You Extract**: Fast search listing summaries are charged as `search-item`, and full factory detail offers with SKU matrices and packaging weights are charged as `detail-item`.
- **Automatic Subscription Volume Discounts**: If you have an Apify paid subscription (Bronze, Silver, Gold, Platinum, Diamond), you automatically receive discounted rates on every product scraped.

> \[!TIP]
> **Check Current Rates**: Please visit the **Pricing tab** at the top of this Actor page for current exact rates across all Apify subscription tiers.

***

### 🎯 Ready-to-Use Sourcing Tasks (1-Click Templates)

Save hours of manual research with our pre-configured sourcing templates. Click **Open & Run** on any template below to launch directly in your Apify Console with pre-tuned parameters (proven regional clusters, verified factory filters, and sales volume sorting):

#### 🔥 "Find on 1688" 1-Click Search Tasks

| Sourcing Objective | 1-Click Template | Key Focus | Direct Run |
| :--- | :--- | :--- | :---: |
| 🔍 **General Product Sourcing Engine** | [`find-products-on-1688`](https://console.apify.com/actors/tasks/v2yehpzDGitW4ukaH/input) | Universal wholesale engine, tiered prices, MOQ, and factory specs | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/v2yehpzDGitW4ukaH/input) |
| 🚀 **Trending & Viral Products** | [`find-trending-products-on-1688`](https://console.apify.com/actors/tasks/fp4ydybo9hNrTIt0T/input) | Top viral bestsellers sorted by booked transaction volume | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/fp4ydybo9hNrTIt0T/input) |
| 📦 **Dropshipping Products** | [`find-dropshipping-products-on-1688`](https://console.apify.com/actors/tasks/4E4aVMg13cDOyqLtL/input) | Low MOQ, export packaging, fast 24-48h dispatch | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/4E4aVMg13cDOyqLtL/input) |
| 👕 **Clothing & Streetwear Apparel** | [`find-clothing-on-1688`](https://console.apify.com/actors/tasks/U9k4UljYPNxvjO2GA/input) | Hoodies, t-shirts, dresses, and blanks from Guangdong OEM factories | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/U9k4UljYPNxvjO2GA/input) |
| 👟 **Shoes & Sneakers** | [`find-shoes-and-sneakers-on-1688`](https://console.apify.com/actors/tasks/zx23Y56vlMD6oUztq/input) | Athletic sneakers, boots, and casual footwear from Fujian plants | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/zx23Y56vlMD6oUztq/input) |
| 🔌 **Electronics & Tech Gadgets** | [`find-electronics-on-1688`](https://console.apify.com/actors/tasks/fYIt8Yj5jPmywVYwg/input) | Chargers, cables, audio, and gadgets from Shenzhen Huaqiangbei | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/fYIt8Yj5jPmywVYwg/input) |
| 💄 **Beauty & Skincare Cosmetics** | [`find-beauty-products-on-1688`](https://console.apify.com/actors/tasks/iUlggIAH5LTHZvJdy/input) | Private label cosmetics, makeup palettes, and skincare | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/iUlggIAH5LTHZvJdy/input) |
| 🧸 **Toys & Hobbies** | [`find-toys-on-1688`](https://console.apify.com/actors/tasks/0UWzVydfMVUj9G1f6/input) | RC drones, plush dolls, and educational toys from Chenghai hub | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/0UWzVydfMVUj9G1f6/input) |
| 🏡 **Home Decor & Furnishings** | [`find-home-decor-on-1688`](https://console.apify.com/actors/tasks/z0XnvTxqsPa7gy827/input) | Aesthetic housewares, kitchenware, and storage organizers | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/z0XnvTxqsPa7gy827/input) |
| 🎒 **Bags & Luggage** | [`find-bags-and-luggage-on-1688`](https://console.apify.com/actors/tasks/oZHMzSmbnbnBXlXns/input) | Travel backpacks, carry-on luggage, and leather handbags | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/oZHMzSmbnbnBXlXns/input) |
| 💍 **Fashion Jewelry** | [`find-jewelry-on-1688`](https://console.apify.com/actors/tasks/BDdP9zAsnNxN0cAgX/input) | 18K gold-plated stainless steel, waterproof jewelry from Yiwu | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/BDdP9zAsnNxN0cAgX/input) |
| 🐾 **Pet Supplies** | [`find-pet-products-on-1688`](https://console.apify.com/actors/tasks/TW2WHnCMasF8FUIXF/input) | Dog harnesses, interactive toys, grooming tools, and pet beds | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/TW2WHnCMasF8FUIXF/input) |
| 🏋️ **Fitness & Gym Gear** | [`find-fitness-gear-on-1688`](https://console.apify.com/actors/tasks/EzAsFNjTxiE1PTUNA/input) | Yoga mats, resistance bands, dumbbells, and active equipment | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/EzAsFNjTxiE1PTUNA/input) |
| 🏭 **Verified Super Factories** | [`find-super-factories-on-1688`](https://console.apify.com/actors/tasks/awLm18EsRiMbdL6Wb/input) | Exclusively audited mega-factories (超级工厂) & inspected plants | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/awLm18EsRiMbdL6Wb/input) |

#### 📱 Specialized Wholesale Category Presets

| Wholesale Category | Preset Template | Key Focus | Direct Run |
| :--- | :--- | :--- | :---: |
| 📱 **Phone Cases & Mobile Accessories** | [`1688-phone-case-accessories-wholesale`](https://console.apify.com/actors/tasks/eTUTmgRIyOv8sDq3U/input) | Top Guangdong factories, full variant matrices, bestsellers | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/eTUTmgRIyOv8sDq3U/input) |
| 🎧 **Wireless Earbuds & Audio** | [`1688-wireless-earbuds-audio-manufacturers`](https://console.apify.com/actors/tasks/fWn5YX08zOS8jCi8C/input) | Bluetooth 5.3 earbuds, ANC headphones, FBA package weights | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/fWn5YX08zOS8jCi8C/input) |
| ⌚ **Smartwatches & Wearables** | [`1688-smart-watch-electronics-procurement`](https://console.apify.com/actors/tasks/EfhJTAnMWJKRUX4RR/input) | Fitness trackers, smart bands, verified Super Factories | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/EfhJTAnMWJKRUX4RR/input) |
| 👕 **Streetwear Hoodies & Blank Apparel** | [`1688-hoodies-streetwear-apparel-factory`](https://console.apify.com/actors/tasks/X2jrrDA48IaJUWfAn/input) | French terry blanks, heavyweight hoodies, OEM custom clothing | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/X2jrrDA48IaJUWfAn/input) |
| 📦 **Amazon FBA & Cross-Border Bestsellers** | [`1688-cross-border-fba-bestsellers-sourcing`](https://console.apify.com/actors/tasks/bJWG561BclAUxzGs3/input) | Export-ready products with exact package weights & fast dispatch | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/bJWG561BclAUxzGs3/input) |
| 🏪 **Yiwu Small Commodities & Novelties** | [`1688-small-commodities-yiwu-market`](https://console.apify.com/actors/tasks/JqLKYUcgeyYWXL7tn/input) | Budget sundries, impulse buys, stationery from Yiwu wholesale market | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/JqLKYUcgeyYWXL7tn/input) |
| 🎒 **Travel Backpacks & Luggage** | [`1688-backpacks-travel-luggage-wholesale`](https://console.apify.com/actors/tasks/JBRe8zKGUjLnSA99y/input) | Waterproof bags, carry-ons, audited luggage manufacturers | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/JBRe8zKGUjLnSA99y/input) |
| 🍳 **Kitchen Gadgets & Home Goods** | [`1688-home-kitchen-gadgets-manufacturer`](https://console.apify.com/actors/tasks/TQdUd1zfLuTlsQLaM/input) | Aesthetic silicone tools, food organizers, tiered bulk prices | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/TQdUd1zfLuTlsQLaM/input) |
| 🐾 **Pet Supplies & Accessories** | [`1688-pet-supplies-accessories-factory`](https://console.apify.com/actors/tasks/rzJa5pfCbm1wKHa1S/input) | Dog harnesses, interactive cat toys, plush pet beds | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/rzJa5pfCbm1wKHa1S/input) |
| 💍 **Fashion Jewelry & Stainless Steel** | [`1688-fashion-jewelry-accessories-wholesale`](https://console.apify.com/actors/tasks/t1lSiqp3YEZdG9XUI/input) | 18K gold-plated stainless steel, waterproof rings & necklaces | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/t1lSiqp3YEZdG9XUI/input) |
| 🏭 **Verified Super Factories Only** | [`1688-super-factory-verified-sourcing`](https://console.apify.com/actors/tasks/3TFtOPytTEv0UOcTM/input) | Exclusively audited, large-scale industrial plants | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/3TFtOPytTEv0UOcTM/input) |
| 🚗 **Automotive Interior & Accessories** | [`1688-automotive-car-accessories-wholesale`](https://console.apify.com/actors/tasks/HcSve1cG5Tqc0EUaW/input) | Dashcams, ambient lighting, seat covers, detailing goods | [⚡ **Open & Run**](https://console.apify.com/actors/tasks/HcSve1cG5Tqc0EUaW/input) |

> \[!TIP]
>
> ### 💡 Can't Find Your Exact Niche? Customize Any Template in 5 Seconds!
>
> You are **never limited** to the presets above. You can scrape any category across all of 1688.com:
>
> 1. **Pick any template above** (or use the main Actor) to open the input page.
> 2. **Enter your own keywords** in the **Search Keyword** field (e.g., `"thermal coffee tumbler"`, `"led nail lamp"`, `"linen sundress"`, or Chinese terms like `"保温杯"`).
> 3. **Or paste any 1688 link directly**: You can copy-paste any product URL or search results URL from `1688.com` directly into the **Start URLs** field.
> 4. Click **Start** to extract thousands of factory offers with full wholesale pricing and supplier credentials!

***

### 💡 Smart Sourcing Tips for Global Importers

1. **Spot True Manufacturers vs. Middlemen**:
   - Turn on the **Super Factory (超级工厂)** or **Factory Inspection (深度验厂)** filters. These badges require physical on-site facility audits and government business licenses, ensuring you aren't paying middleman markups.
2. **Use the Repurchase Rate (回头率) as a Quality Filter**:
   - On 1688, a repurchase rate above **30%–40%** indicates that Chinese domestic retailers repeatedly reorder this product. It is one of the strongest indicators of consistent product quality.
3. **Check the Tiered Bulk Prices**:
   - Chinese factories love volume. The tiered pricing table shows you what large domestic distributors pay, giving you immediate bargaining power when ordering samples or production runs.
4. **Source from the Right Chinese Regions**:
   - **Guangdong Province (Shenzhen, Dongguan, Guangzhou)**: Electronics, phone accessories, audio, modern apparel.
   - **Zhejiang Province (Yiwu, Ningbo, Wenzhou)**: Small commodities, stationery, home organizers, hardware, jewelry.
   - **Jiangsu Province (Suzhou, Nantong)**: Textiles, bedding, home decor, plush toys.
   - **Fujian Province (Quanzhou, Putian)**: Footwear, outdoor bags, sports gear.

***

### 📥 Exporting Your Data & No-Code Automations

Once your run is complete, you can download your data or connect it to your daily business tools:

#### Export Options

- **Microsoft Excel (.xlsx)**: Clean, pre-formatted spreadsheet ready for filtering, calculations, and formulas.
- **CSV**: Universal spreadsheet format for Google Sheets, Airtable, or inventory databases.
- **JSON / XML**: Ready to integrate with your custom store apps, inventory feeds, or data pipelines.
- **API & Webhooks**: Seamlessly trigger runs from Zapier, Make.com, or your internal order management system.

#### No-Code Workflows (Make.com & Zapier)

- **Auto-Sync to Google Sheets / Airtable**: Automatically add newly discovered products, wholesale prices, and supplier links into your team's spreadsheet as soon as a scraper run finishes.
- **Draft Products in Shopify / WooCommerce**: Automatically create draft listings with variant prices, color options, and image URLs.
- **Stock & Price Drop Alerts**: Trigger instant notifications in Slack, Discord, or Email whenever a supplier changes prices or updates stock.

#### Hands-Free Recurring Monitoring (Apify Schedules)

- Open the **Schedules** tab in the Apify Console.
- Choose your schedule frequency (e.g. *Every Monday at 8:00 AM* or *Daily*).
- The scraper runs automatically in the background, keeping your product pricing and supplier intelligence up to date hands-free.

***

### ❓ Frequently Asked Questions (FAQ)

##### Do I need a 1688 account or Chinese phone number to use this scraper?

No. You do not need any 1688 account, login credentials, or Chinese phone number. All data extraction runs seamlessly in the background on the Apify platform.

##### Does this scraper support English keywords?

Yes. You can search in English (e.g. `phone case`, `smart watch`) or Chinese (e.g. `手机壳`, `蓝牙耳机`). Chinese keywords often return a wider selection of domestic manufacturers.

##### How do I export my data to Excel or Google Sheets?

Once your scraper run completes, click the **Export** button in the Apify Console. You can immediately download your clean dataset in **Microsoft Excel (.xlsx)**, **CSV**, **JSON**, or sync it directly to **Google Sheets**.

##### How is this scraper billed?

This scraper uses Apify's transparent **Pay-Per-Event (PPE)** pricing model. You only pay for the products you successfully scrape—never for idle server time. Check the **Pricing tab** at the top of this page for up-to-date rates and automatic subscription tier discounts.

##### Why is the Customer Repurchase Rate (回头率) so important?

The repeat-customer rate (回头率) measures the percentage of buyers who reorder from that specific manufacturer within a rolling period. A high repurchase rate (30%+) is the single best metric to verify reliable product quality on 1688.

##### Can I scrape specific product links or search URLs copied from 1688?

Yes. Simply paste one or more 1688 URLs directly into **Start URLs**. You can paste direct product offer links (e.g. `https://detail.1688.com/offer/685176373959.html`), numeric Offer IDs (`685176373959`), or search listing URLs (e.g. `https://s.1688.com/selloffer/offer_search.htm?keywords=hoodie`). The scraper automatically detects the URL type, parses embedded filters, and routes each item cleanly.

##### How does this work with AI agents via MCP?

By configuring the Apify MCP Server (`https://mcp.apify.com`) in your AI assistant (Claude Desktop, Cursor, Windsurf), your assistant can autonomously run `scraperpro/1688-wholesale-scraper` as a tool, inspect the structured output schema, compare factories, calculate landed margins, and translate product attributes on demand.

***

### 🤝 Support & Feedback

Need help with sourcing, bulk extractions, or custom integrations? Reach out anytime via the **Issues** tab or contact our team through the Apify Console.

# Actor input Schema

## `keyword` (type: `string`):

Keyword in English or Chinese (e.g. 'phone case', '手机壳', '蓝牙耳机', 'T恤', '水杯', '玩具'). Ignored if startUrls or searchUrls are provided.

## `startUrls` (type: `array`):

Paste any 1688 URLs directly from your browser: direct product offer links (e.g. 'https://detail.1688.com/offer/685176373959.html'), numeric offer IDs ('685176373959'), or search listing URLs (e.g. 'https://s.1688.com/selloffer/offer\_search.htm?keywords=hoodie'). The scraper automatically detects and routes them.

## `searchUrls` (type: `array`):

Optional list of 1688 search listing URLs. Note: you can also paste search URLs directly into 'Start URLs' above.

## `maxItems` (type: `integer`):

Maximum number of wholesale offers to scrape (1 to 1,500).

## `detailLevel` (type: `string`):

Choose 'Full B2B Mode' for complete wholesale tiered volume prices, full color/size SKU variations, MOQ, and verified factory audit badges; or 'Summary Mode' for fast product search card discovery.

## `sortBy` (type: `string`):

Sorting order of the listings.

## `priceMin` (type: `integer`):

Minimum unit wholesale price in Chinese Yuan (CNY ¥).

## `priceMax` (type: `integer`):

Maximum unit wholesale price in Chinese Yuan (CNY ¥).

## `province` (type: `string`):

Filter by Chinese manufacturing province (e.g. '广东' for Guangdong/Shenzhen/Guangzhou, '浙江' for Zhejiang/Yiwu/Hangzhou, '江苏' for Jiangsu).

## `verticalProductFlag` (type: `string`):

Select the 1688 wholesale channel to query directly at source: 'Direct Factory' for OEM/ODM manufacturers, 'Super Factory' for top mega-factories, 'Cross-Border' for Amazon FBA/export sellers, 'Ready-to-Ship' for in-stock spot items, or 'All Channels'.

## `superFactoryOnly` (type: `boolean`):

Filter to only include verified Super Factories (超级工厂 / 实力商家) with certified manufacturing facilities.

## `factoryInspectionOnly` (type: `boolean`):

Filter to only include suppliers with verified on-site 3rd-party factory inspection (深度验厂).

## `proxyConfiguration` (type: `object`):

Apify Residential Proxy is strongly recommended. 1688 (Alibaba) aggressively blocks datacenter IPs.

## Actor input object example

```json
{
  "keyword": "phone case",
  "maxItems": 30,
  "detailLevel": "full",
  "sortBy": "normal",
  "province": "",
  "verticalProductFlag": "factory",
  "superFactoryOnly": false,
  "factoryInspectionOnly": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Extracted 1688 B2B wholesale offers, tiered pricing, and factory intelligence

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keyword": "phone case",
    "maxItems": 30,
    "detailLevel": "full",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraperpro/1688-wholesale-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keyword": "phone case",
    "maxItems": 30,
    "detailLevel": "full",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("scraperpro/1688-wholesale-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keyword": "phone case",
  "maxItems": 30,
  "detailLevel": "full",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call scraperpro/1688-wholesale-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scraperpro/1688-wholesale-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/M5S1OECxbMeNY8AzG/builds/lFKaWjba4IKzynQJP/openapi.json
