# 1688.com Wholesale & Factory Scraper (阿里巴巴批发网) 🇨🇳 (`unitbytes/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/unitbytes/1688-wholesale-scraper.md
- **Developed by:** [UnitBytes | Enterprise Web Data](https://apify.com/unitbytes) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.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 Scraper: 1688.com Wholesale & Factory Scraper API (阿里巴巴批发网)

<div align="center">

[![Available on Apify](https://img.shields.io/badge/Available_on-Apify-28B52A?style=for-the-badge\&logo=apify\&logoColor=white)](https://apify.com/unitbytes/1688-wholesale-scraper?fpr=939u3w\&fp_sid=gh_1688)
[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg?style=for-the-badge)](#)
[![Success Rate](https://img.shields.io/badge/Success_Rate-99%25+-brightgreen?style=for-the-badge)](#)
[![Zero Login](https://img.shields.io/badge/Account_Required-None-blue?style=for-the-badge)](#)
[![Pricing](https://img.shields.io/badge/Pricing-Pay_Per_Result-orange?style=for-the-badge)](#)
[![Factory Audit](https://img.shields.io/badge/Factory_Audit-Verified_SGS%2FBV-purple?style=for-the-badge)](#)

**The most advanced 1688 and 1688.com (Alibaba Wholesale) scraper and supplier intelligence tool for Amazon FBA merchants, Shopify brands, dropshippers, procurement managers, and cross-border e-commerce sellers. Extract true factory bulk prices from 1688 / 1688.com, tiered volume discounts, minimum order quantities (MOQ), complete SKU variant matrices with matching photos, Amazon FBA packaging weights, and verified Super Factory (超级工厂) audit badges — 100% autonomously with Zero Login & Zero Chinese Phone Number Required.**

[**🚀 Try it Live on Apify**](https://apify.com/unitbytes/1688-wholesale-scraper?fpr=939u3w\&fp_sid=gh_1688) • [**📖 Documentation**](https://apify.com/unitbytes/1688-wholesale-scraper?fpr=939u3w\&fp_sid=gh_1688) • [**💬 Support**](https://apify.com/unitbytes/1688-wholesale-scraper/issues)

</div>

***

<p align="center">
  <a href="https://console.apify.com/actors/M5S1OECxbMeNY8AzG/input">
    <img src="https://raw.githubusercontent.com/unitbytes-com/1688-Wholesale-Scraper-API/main/1688_scraper_banner.jpg" alt="1688 Wholesale &amp; Factory Scraper by UnitBytes" width="100%">
  </a>
</p>

<p align="center">
  <a href="https://console.apify.com/actors/M5S1OECxbMeNY8AzG/input">
    <img src="https://raw.githubusercontent.com/unitbytes-com/1688-Wholesale-Scraper-API/main/try-it-for-free.svg" width="240" height="48" alt="Try it for Free">
  </a>
  <br>
  <sub>⚡ <b>1-Click Free Trial:</b> Test live queries using Apify's $5 free monthly credit • No credit card required</sub>
</p>

***

### 📖 Overview

**1688.com (阿里巴巴批发网)** is Alibaba Group's premier domestic B2B marketplace. It is the real, direct manufacturing engine behind Alibaba.com, AliExpress, Temu, Shein, Taobao, and Amazon FBA — hosting over **10 million Chinese factories, raw manufacturers, and industrial suppliers**.

However, extracting data from 1688 has historically been a massive headache for Western brands and sourcing teams:

- Mandatory Chinese mobile number (+86) SMS verification and QR code login walls.
- Dynamic Alibaba mtop token encryption (`_m_h5_tk`, `tfstk`) and anti-bot challenges.
- Chinese character GBK encoding that corrupts URLs and keyword search terms.
- Complex nested variation trees and pricing tiers hidden behind authenticated AJAX calls.

**1688 Wholesale Scraper by UnitBytes** completely solves these procurement roadblocks. Powered by an autonomous extraction engine, this Actor extracts up to **10,000 items per run** with **10 parallel workers** — delivering clean, spreadsheet-ready factory data into Excel, CSV, or Google Sheets with zero account or cookie setup needed.

<table>
  <tr>
    <td colspan="4" style="padding:10px 14px;background:#FF6A00;color:#FFFFFF;font-size:13px;font-weight:700;border-radius:6px 6px 0 0">
      ⚡ UnitBytes · Chinese E-Commerce &amp; B2B Sourcing Ecosystem
    </td>
  </tr>
  <tr>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:25%">
      <span style="white-space:nowrap">🌐 <b><a href="https://apify.com/unitbytes/alibaba-wholesale-scraper?fpr=939u3w&fp_sid=gh_alibaba" style="color:#0F172A;text-decoration:none;font-size:13px">Alibaba Wholesale</a></b></span><br>
      <span style="color:#2563EB;font-size:11px;font-weight:600">Global B2B Wholesale</span><br>
      <span style="color:#64748B;font-size:11px">Tiered prices, MOQ &amp; audits</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FFF4ED;vertical-align:top;width:25%">
      <span style="white-space:nowrap">🇨🇳 <b><a href="https://apify.com/unitbytes/1688-wholesale-scraper?fpr=939u3w&fp_sid=gh_1688" style="color:#C2410C;text-decoration:none;font-size:13px">1688 Factory Direct</a></b></span><br>
      <span style="color:#EA580C;font-size:11px;font-weight:700">📍 You are here</span><br>
      <span style="color:#64748B;font-size:11px">Domestic factory prices &amp; SKUs</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:25%">
      <span style="white-space:nowrap">🐟 <b><a href="https://apify.com/unitbytes/goofish-xianyu-search-scraper?fpr=939u3w&fp_sid=gh_goofish" style="color:#0F172A;text-decoration:none;font-size:13px">Goofish Products</a></b></span><br>
      <span style="color:#2563EB;font-size:11px;font-weight:600">C2C Resale &amp; Arbitrage</span><br>
      <span style="color:#64748B;font-size:11px">Zero-login search engine</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:25%">
      <span style="white-space:nowrap">⭐ <b><a href="https://apify.com/unitbytes/goofish-xianyu-seller-scraper?fpr=939u3w&fp_sid=gh_goofish_seller" style="color:#0F172A;text-decoration:none;font-size:13px">Goofish Sellers</a></b></span><br>
      <span style="color:#2563EB;font-size:11px;font-weight:600">Merchant Due Diligence</span><br>
      <span style="color:#64748B;font-size:11px">Zhima credit &amp; reviews</span>
    </td>
  </tr>
</table>

***

### 🌟 Why Sourcing Teams Choose UnitBytes

| Sourcing Capability | UnitBytes 1688 Scraper | Alternative Scrapers | Generic Web Crawlers |
| :--- | :---: | :---: | :---: |
| **Pricing Model** | **Pay-Per-Result (PPE)** | Expensive Monthly Subscriptions ($100-$300/mo) | High hourly server fees ($0.40/CU) |
| **Account / Login Requirement** | **None (100% Worldwide Access)** | Requires Chinese (+86) Phone & Alipay | Manual session cookies required |
| **Dual Extraction Modes** | **Summary (Fast & Cheap) + Full Detail** | ❌ Flat high rate only | Unpredictable compute costs |
| **Dedicated Wholesale Channels** | ✅ **Direct Factory, Super Factory, Cross-Border Export, Spot Market** | ❌ Keyword search only | ❌ None |
| **Tiered Volume Price Matrix** | ✅ **Full Multi-Bracket Quantity Tiers** | ❌ Single starting price only | ❌ Missing volume brackets |
| **Amazon FBA Packaging Dimensions** | ✅ **Exact Grams & Dimensions per SKU** | ❌ Not available | ❌ Not available |
| **Full SKU Variant Matrix + Photos** | ✅ **All Variants, Live Inventory & Spec Photos** | ⚠️ Incomplete or text-only | ❌ Missing variant stock |
| **Factory Due Diligence Badges** | ✅ **Super Factory, 深度验厂, 回头率** | ⚠️ Charged as paid add-on | ❌ Missing |
| **Pagination Resumption** | ✅ **Encrypted `resumptionToken`** | ❌ Restarts from page 1 | ❌ None |
| **Chinese Character URL Decoding** | ✅ **Automatic GBK & UTF-8 Auto-Routing** | ❌ Corrupts GBK query strings | ❌ None |
| **Export Formats** | ✅ **Excel (.xlsx), CSV, Google Sheets, JSON** | ⚠️ JSON / CSV only | ⚠️ Unstructured raw HTML |

<p align="center">
  <a href="https://console.apify.com/actors/M5S1OECxbMeNY8AzG/input">
    <img src="https://raw.githubusercontent.com/unitbytes-com/1688-Wholesale-Scraper-API/main/try-it-for-free.svg" width="240" height="48" alt="Try it for Free">
  </a>
</p>

***

### ✨ Key Features

- **🏭 4 Specialized Wholesale Sourcing Channels:** Query specialized 1688 channels at the source:
  - `找工厂` (Direct Factory / OEM & ODM) — filters out middlemen and trading agents.
  - `超级工厂` (Super Factory) — restricted to Alibaba's elite certified mega-plants.
  - `跨境专供` (Cross-Border Export) — tailored for Amazon FBA, Temu, and TikTok Shop sellers with CE/FCC/RoHS compliance.
  - `现货批发` (Ready-to-Ship Spot Market) — in-stock items ready to ship in 24–48 hours.
- **💰 Tiered Bulk Pricing Brackets:** Captures the full volume price schedule (e.g. 2–99 pcs, 100–499 pcs, 500+ pcs) for accurate cost modeling and supplier negotiation.
- **📦 Amazon FBA Packaging Intelligence:** Extracts physical package weights in grams (`weightGrams`) and physical dimensions (`lengthCm`, `widthCm`, `heightCm`, `volumeCm3`) per individual SKU variant to accurately calculate international freight and FBA fulfillment fees.
- **🎨 Complete SKU Matrix with Spec Photos:** Collects every variation (color, size, packaging) along with variant-specific pricing, real-time stock levels, and matching high-res product photos.
- **🛡️ Factory Due Diligence Badges:** Verify manufacturing capability instantly with **Super Factory (超级工厂)** flags, **SGS / BV third-party on-site audits (深度验厂)**, and repeat customer **Repurchase Rates (回头率)**.
- **🔄 Stateful Resumption Engine (`resumptionToken`):** Checkpoints pagination state so you can resume multi-page scrapes seamlessly with **0 duplicate products across runs**.
- **⚡ High Concurrency & Speed:** 10 parallel workers extract thousands of listings without crashing or slowing down.

***

### 💡 Practical Business Use Cases

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

Calculate landed product costs accurately before placing production orders. Combine extracted physical SKU package weights (grams) and dimensions with bulk volume tier prices to model international air/sea freight and Amazon FBA fulfillment size tiers.

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

Uncover trending viral products before they reach Western marketplaces. Sort by total sales volume (`salesVolume` / Booked Orders) and enrich your product catalogs with high-res photo galleries, SKU matrices, and product demo videos.

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

Cut out export trading companies, domestic commission agents, and unnecessary markups. Filter strictly for verified **Super Factories (超级工厂)** and facilities with verified third-party on-site factory audits (**深度验厂**).

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

Benchmark real manufacturing costs in China against retail prices on Amazon, eBay, Mercari, and Walmart. Gain immediate leverage during price negotiations by showing suppliers their competitors' domestic 1688 wholesale prices.

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

Directly target Zhejiang and Yiwu wholesale markets to source novelties, home organizers, stationery, and small accessories at fraction-of-a-cent factory rates.

***

### 🛠️ How to Use via API

You can trigger runs directly in the [Apify Console](https://apify.com/unitbytes/1688-wholesale-scraper?fpr=939u3w\&fp_sid=gh_1688) or integrate programmatically into your Python, Node.js, or cURL pipeline.

#### 🐍 Python Example

```bash
pip install apify-client
```

```python
from apify_client import ApifyClient

## Initialize the client with your Apify API token
client = ApifyClient("YOUR_APIFY_TOKEN")

## Configure search parameters
run_input = {
    "keyword": "phone case",
    "detailLevel": "full",
    "maxItems": 50,
    "sortBy": "booked",
    "province": "广东",
    "superFactoryOnly": True,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

## Run the Actor and wait for completion
print("🚀 Launching 1688 Factory Scraper...")
run = client.actor(\"unitbytes/1688-wholesale-scraper\").call(run_input=run_input)

## Fetch scraped wholesale products from the dataset
dataset_items = client.dataset(run["defaultDatasetId"]).list_items().items
print(f"✅ Successfully extracted {len(dataset_items)} wholesale products from 1688!")

for item in dataset_items[:3]:
    print(f"\nTitle: {item.get('title')}")
    print(f"Base Price: ¥{item.get('price')} CNY")
    print(f"Price Range: {item.get('priceDisplay')}")
    print(f"MOQ: {item.get('minOrderQuantity')} units")
    print(f"Super Factory: {item.get('superFactory')}")
    print(f"Repurchase Rate: {item.get('repurchaseRate')}")
    print(f"Supplier: {item.get('supplier', {}).get('name')}")
    print(f"URL: {item.get('url')}")
```

***

#### 🟨 JavaScript / Node.js Example

```bash
npm install apify-client
```

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

const client = new ApifyClient({
    token: 'YOUR_APIFY_TOKEN',
});

const runInput = {
    keyword: 'hoodie',
    detailLevel: 'summary',
    maxItems: 100,
    sortBy: 'priceAsc',
    priceMin: 20,
    priceMax: 60,
    province: '浙江',
    proxyConfiguration: {
        useApifyProxy: true,
        apifyProxyGroups: ['RESIDENTIAL'],
    },
};

console.log('🚀 Starting 1688 Scraper...');
const run = await client.actor(\"unitbytes/1688-wholesale-scraper\").call(runInput);

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`✅ Extracted ${items.length} products from 1688!`);

console.log(items.slice(0, 2));
```

***

#### 🌐 cURL Example

```bash
curl -X POST "https://api.apify.com/v2/acts/unitbytes~1688-wholesale-scraper/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "wireless earbuds",
    "detailLevel": "full",
    "maxItems": 30,
    "superFactoryOnly": true
  }'
```

***

### 📤 Sample Output Data

<div align="center">
  <img src="1688_Scraper_apify_Actor.jpeg" alt="1688 Wholesale Scraper Apify Dataset Preview" width="100%">
</div>

Here is an example of an enriched 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外壳纯色",
  "page": 1,
  "position": 1,
  "nextPage": 2,
  "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"
  ],
  "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小时发货",
    "isFreeShipping": true
  },
  "supplier": {
    "companyName": "东莞市清运手机配件制造厂",
    "name": "东莞市清运手机配件制造厂",
    "city": "东莞市",
    "province": "广东省",
    "trustPass": true,
    "shopUrl": "https://winport.m.1688.com/page/index.html?memberId=b2b-221468779952686089"
  },
  "detailLevel": "full"
}
```

***

### ⚙️ Input Parameters Reference

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `keyword` | `string` | — | Product search query in English or Chinese (e.g. `phone case`, `hoodie`, `wireless earbuds`, `瑜伽裤`). You can also paste direct 1688 URLs! |
| `startUrls` | `array` | `[]` | Direct 1688 product offer URLs (`detail.1688.com/offer/...`), numeric offer IDs, or search result URLs. |
| `detailLevel` | `string` | `"full"` | `"summary"` (fast search scan) or `"full"` (tiered pricing, SKU matrix, packaging weights, and factory audit badges). |
| `maxItems` | `integer` | `100` | Maximum number of products to collect (supports large jobs up to 10,000 items). |
| `sortBy` | `string` | `"normal"` | Sort order: `normal` (comprehensive), `booked` (sales volume), `priceAsc`, `priceDesc`. |
| `priceMin` | `integer` | — | Minimum wholesale price in Chinese Yuan (¥ CNY). |
| `priceMax` | `integer` | — | Maximum wholesale price in Chinese Yuan (¥ CNY). |
| `province` | `string` | — | Filter by manufacturing province (e.g. `广东` for electronics/apparel, `浙江` for Yiwu small commodities). |
| `superFactoryOnly`| `boolean`| `false` | When true, restricts results strictly to Alibaba-certified **Super Factories (超级工厂)**. |
| `factoryInspectionOnly` | `boolean` | `false` | When true, restricts to plants with third-party on-site verification audits (**深度验厂**). |
| `proxyConfiguration` | `object` | Residential | Apify Proxy configuration (residential proxies required for high throughput). |

***

### ❓ Frequently Asked Questions (FAQ)

#### Do I need a 1688 account, Alipay, or Chinese phone number?

**No.** The scraper operates entirely autonomously without requiring an account, phone number (+86), or session cookies.

#### Can I search using English keywords?

**Yes.** Standard English terms (e.g. `phone case`, `yoga pants`, `hoodie`, `earbuds`, `smart watch`) are supported. Sourcing teams often also search with native Chinese product terms (e.g. `手机壳`, `运动裤`, `蓝牙耳机`) for maximum supplier discovery.

#### How do I use the Amazon FBA packaging weights and dimensions?

Every record in **Full Detail** mode includes the physical `weightGrams` and dimensions (`lengthCm`, `widthCm`, `heightCm`) per variant. Use these numbers directly in your Amazon FBA revenue calculator to determine exact shipping and fulfillment fees.

#### What is the difference between Super Factory and Factory Inspection?

- **Super Factory (超级工厂):** Alibaba's highest verified certification tier awarded to large-scale manufacturers with substantial annual revenue, modern production lines, and direct factory management.
- **Factory Inspection (深度验厂):** Facilities audited physically on-site by accredited third-party inspection firms (such as SGS or Bureau Veritas) to verify worker counts, factory square footage, and production machinery.

#### How does pagination resumption work?

Every exported item and run summary includes an encrypted **`resumptionToken`**. If you want to continue a massive scrape without re-extracting previous items, simply pass the token into your next run's input.

***

### 📞 Support & Custom Sourcing Pipelines

Need custom data pipelines, ERP / inventory integration, or high-volume enterprise crawls?

- **Apify Actor Store:** [1688 Wholesale & Factory Scraper](https://apify.com/unitbytes/1688-wholesale-scraper?fpr=939u3w\&fp_sid=gh_1688)
- **Bug Reports & Sourcing Requests:** [Apify Issues](https://apify.com/unitbytes/1688-wholesale-scraper/issues)
- **Author:** UnitBytes

<div align="center">
  <br>
  <a href="https://apify.com/unitbytes/1688-wholesale-scraper?fpr=939u3w&fp_sid=gh_1688">
    <img src="https://img.shields.io/badge/Start_Scraping_Now-Apify-28B52A?style=for-the-badge&logo=apify&logoColor=white" height="40" alt="Start Scraping Now">
  </a>
</div>

***

### 🔍 Keywords & Search Tags

`1688` • `1688.com` • `1688-scraper` • `1688.com-scraper` • `1688-api` • `1688.com-api` • `1688-wholesale` • `1688.com-wholesale` • `1688-factory-sourcing` • `1688.com-factory-sourcing` • `scrape-1688` • `scrape-1688.com` • `alibaba-wholesale-scraper` • `1688-crawler` • `1688.com-crawler` • `1688-product-scraper` • `1688爬虫` • `1688.com爬虫` • `1688数据采集` • `alibaba-1688-python` • `amazon-fba-sourcing` • `china-factory-scraper` • `dropshipping-sourcing-agent` • `super-factory-1688` • `yiwu-market-scraper` • `cross-border-ecommerce` • `apify-actor` • `oem-odm-china-manufacturers` • `1688-price-monitor`

# Actor input Schema

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

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

## `offerIds` (type: `array`):

Optional list of numeric 1688 wholesale product offer IDs (e.g. '685176373959', '1015804349214'). Directly extracts full B2B details, tiered volume prices, and SKU matrices for each product without searching.

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

Paste any 1688 URLs directly from your browser: direct product offer links (e.g. 'https://detail.1688.com/offer/685176373959.html') or search listing URLs (e.g. 'https://s.1688.com/selloffer/offer\_search.htm?keywords=hoodie'). You can also use 'Direct Offer IDs' to enter raw IDs.

## `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 10,000).

## `resumptionToken` (type: `string`):

Optional encrypted resumption token copied from a previous run, Key-Value store, or dataset item. Restores the exact session and continues scraping directly from where it left off without starting over.

## `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"
    ],
    "apifyProxyCountry": "HK"
  }
}
```

# 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"
        ],
        "apifyProxyCountry": "HK"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("unitbytes/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"],
        "apifyProxyCountry": "HK",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("unitbytes/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"
    ],
    "apifyProxyCountry": "HK"
  }
}' |
apify call unitbytes/1688-wholesale-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,unitbytes/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/8X6UhjrcxirjRwjOo/openapi.json
