# Alibaba Scraper: Alibaba.com Wholesale & Verified Suppliers 🌐 (`scraperpro/alibaba-wholesale-scraper`) Actor

Fastest, cheapest Alibaba.com scraper. Extracts B2B wholesale tiered pricing, MOQ, Verified Supplier credentials (TÜV/SGS), Gold Supplier tenure, lead times, specifications, and full HD photos from Alibaba.com.

- **URL**: https://apify.com/scraperpro/alibaba-wholesale-scraper.md
- **Developed by:** [ScraperPro](https://apify.com/scraperpro) (community)
- **Categories:** E-commerce, Lead generation
- **Stats:** 2 total users, 1 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

<p align="center">
  <a href="https://console.apify.com/actors/4lwSVTtOQcpewsKCf/input">
    <img src="https://raw.githubusercontent.com/RNFS/1688-Wholesale-Scraper-API/main/alibaba_scraper_banner.jpg" alt="Alibaba Wholesale Data Scraper Banner" width="100%" />
  </a>
</p>

## 🌐 Alibaba Scraper: Alibaba.com Wholesale Products & Verified Suppliers 🇨🇳 🌍

<p align="center">
  <a href="https://console.apify.com/actors/4lwSVTtOQcpewsKCf/input">
    <img src="https://raw.githubusercontent.com/RNFS/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>

The fastest, cheapest, and most comprehensive **Alibaba.com scraper** and **global B2B wholesale product extractor** on Apify. Built specifically for Amazon FBA brand owners, cross-border e-commerce sellers, Shopify dropshippers, and global procurement teams. Extract direct factory prices from **Alibaba.com**, bulk volume discount tiers, minimum order quantities (MOQ), Verified Supplier audit credentials (TÜV Rheinland / SGS), Gold Supplier tenure, lead times, sample pricing, and **100% working CDN photos (no 403 Forbidden errors)** — exported directly into **Excel (.xlsx)**, **CSV**, or **Google Sheets** with zero coding required.

Whether you are finding genuine international manufacturers on **Alibaba.com**, calculating landed product costs, or empowering autonomous AI sourcing agents, this **Alibaba scraper** automates your entire supplier procurement workflow at scale.

<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">
      ⚡ ScraperPro · Chinese E-Commerce &amp; B2B Sourcing Ecosystem
    </td>
  </tr>
  <tr>
    <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/scraperpro/alibaba-wholesale-scraper?fpr=939u3w&fp_sid=gh_alibaba" style="color:#C2410C;text-decoration:none;font-size:13px">Alibaba Wholesale</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">Global B2B, MOQ &amp; Audits</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/scraperpro/1688-wholesale-scraper?fpr=939u3w&fp_sid=gh_1688" style="color:#0F172A;text-decoration:none;font-size:13px">1688 Factory Direct</a></b></span><br>
      <span style="color:#2563EB;font-size:11px;font-weight:600">Domestic Factory Prices</span><br>
      <span style="color:#64748B;font-size:11px">SKU matrices &amp; FBA specs</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/scraperpro/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/scraperpro/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 This Alibaba Scraper

Most scrapers only extract a basic product title and an approximate single price. This tool was custom-engineered for **professional importers, procurement managers, and e-commerce buyers** who need actionable manufacturer intelligence:

- **Unbeatable Pay-Per-Event Pricing**: Only **$1.50 per 1,000 search items** and **$2.50 per 1,000 full detail items** *(Apify Subscribers: $0.90 & $2.00)* — up to 70% cheaper than others with zero monthly subscription locks.
- **All-in-One Sourcing Engine**: Seamlessly switch between fast catalog discovery (`summary` mode) and comprehensive supplier auditing (`full` mode) inside a single Actor without paying for separate tools.
- **100% Working Image URLs (No 403 Forbidden)**: All extracted product photos and gallery images open reliably and work seamlessly with Shopify, WooCommerce, Excel, Airtable, and Google Sheets.
- **Direct Factory Bulk Pricing**: View the exact tiered volume discount brackets (e.g. 50–199 pcs, 200–999 pcs, 1,000+ pcs) that international buyers receive.
- **Verified Supplier & Audit Credentials**: Cut out middlemen and trading agents by filtering directly for Alibaba-certified **Verified Suppliers** (on-site audited by **TÜV Rheinland** or **SGS**).
- **Trade Assurance Protection**: Identify suppliers that support Alibaba's Trade Assurance payment protection and order safeguards.
- **Lead Time Schedule by Quantity**: Inspect the manufacturer's real production timeline breakdown (e.g. 1–100 pcs: 7 days, 101–500 pcs: 12 days) before requesting samples.
- **Direct Product URLs & Keyword Search**: Pass product URLs directly or search millions of wholesale listings by keyword and category.
- **Blazing Fast Cloud Engine**: Sessions start in under 1 second with instant throughput and enterprise anti-blocking reliability.
- **Ultra-Low Compute Footprint**: Operates within a minimal 512 MB RAM ceiling, saving you up to 85% on Apify compute units (CU).
- **Built-in Session Resumption**: Easily extract 100,000+ items continuously without losing progress or restarting from page one.
- **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 Alibaba Scrapers

| Sourcing Capability | 🌐 This Alibaba Scraper | ⚠️ Other Alibaba Actors | 📦 Generic Web Scrapers |
| :--- | :---: | :---: | :---: |
| **Full Detail Price (per 1,000)** | 🏆 **$2.50** *(Subscribers: $2.00)* | $4.00 – $8.00 / 1k | High compute hours ($0.40/CU) |
| **Search Item Price (per 1,000)** | 🏆 **$1.50** *(Subscribers: $0.90)* | $3.00 – $5.00 / 1k | Unpredictable compute costs |
| **All-in-One Engine** | ✅ **Search + Full B2B Detail** | ❌ Split into 2 separate actors | ❌ None |
| **Start Fee** | **$0.0001** (Virtually Free) | Up to $0.01 (100x higher) | High idle compute |
| **Working CDN Images** | ✅ **100% Guaranteed Working** | ❌ Broken / low-res 300x300 | ❌ Raw / broken |
| **Container Memory** | ⚡ **512 MB RAM (Minimal CU)** | ⚠️ 1,024 MB – 4,096 MB RAM | ⚠️ Heavy browsers |
| **Cold Start Time** | ⚡ **Sub-Second (<1s)** | ⚠️ 20–40s cold boot | ⚠️ 30–60s browser launch |
| **Tiered Volume Pricing** | ✅ **Complete Volume Ladders** | ⚠️ Flat / rough price range only | ❌ Missing |
| **Verified Supplier Audits** | ✅ **TÜV Rheinland & SGS Audits** | ⚠️ Often missing or paid add-on | ❌ None |
| **Trade Assurance Indicator** | ✅ **Included Free** | ⚠️ Inconsistent | ❌ None |
| **Production Lead Times** | ✅ **Full SLA Matrix by Quantity** | ❌ Ignored / Not extracted | ❌ None |
| **Direct Product URLs** | ✅ **Supported (`productUrls`)** | ⚠️ Search keywords only | ❌ None |
| **Session Resumption** | ✅ **Yes (`resumptionToken`)** | ❌ Restarts from page 1 | ❌ None |
| **Max Capacity per Run** | ✅ **100,000+ Items** | ⚠️ Hard 50-page cap (~2,400 items) | ❌ Freezes mid-run |
| **Export Formats** | ✅ **Excel (.xlsx), CSV, Sheets, JSON** | ⚠️ JSON / CSV only | ⚠️ Raw unstructured HTML |

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

***

### 💼 Real-World Use Cases

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

- **Calculate Landed Cost Accurately**: Use extracted bulk volume pricing brackets, sample costs, and minimum order quantities to accurately forecast your profit margins before placing inventory orders.
- **Find High-Capacity B2B Suppliers**: Filter by production lead times and verify supplier manufacturing capacity to prevent stockouts during peak retail seasons.

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

- **Discover Winning Products**: Search trending niches and extract supplier ratings, sales volume signals, and pricing to find high-margin wholesale products.
- **Enrich Store Product Catalogs**: Export high-resolution product image galleries and detailed technical specifications ready for direct import into Shopify, WooCommerce, or BigCommerce.

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

- **Cut Out Middlemen**: Filter strictly for **Verified Suppliers** that have completed on-site facility audits conducted by independent international inspection bodies (**TÜV Rheinland** and **SGS**).
- **Verify Trade History & Tenure**: Check Gold Supplier years active, store reviews, and response ratings to partner with reliable, established manufacturers.

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

- **Benchmark Supplier Costs**: Track wholesale market price shifts across categories and negotiate better terms with existing suppliers using transparent market data.
- **Identify Alternative Manufacturers**: Build an automated supplier directory with verified backup manufacturers in key manufacturing hubs (China, Vietnam, India, Turkey).

#### 5. 🤖 AI Agents & Automated Procurement Workflows

- **Autonomous Sourcing Pipelines**: Integrate seamlessly with Claude, Cursor, Windsurf, or custom AI procurement agents via Apify's API and **MCP Server** integration. Clean, typed schemas make prompt-driven supplier selection fast and deterministic.

***

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

You only pay for what you extract with zero hidden monthly subscriptions:

| Event ID | Event Title | Standard Price (Free Users) | Apify Subscriber Price | What You Get |
| :--- | :--- | :--- | :--- | :--- |
| `search-item` | **Search Product Listing** | **$0.0015** ($1.50 / 1k) | **$0.0009** ($0.90 / 1k) | Product title, price range, MOQ, supplier name, country, review rating, and preview image. |
| `detail-item` | **Full B2B Product Detail & Supplier Audit** | **$0.0025** ($2.50 / 1k) | **$0.0020** ($2.00 / 1k) | Complete tiered volume discount ladders, MOQ, sample pricing, lead time schedule, TÜV/SGS audit credentials, Trade Assurance, and full technical specifications. |
| `apify-actor-start` | **Actor Start** | **$0.0001** ($0.10 / 1k) | **$0.0001** ($0.10 / 1k) | Nominal platform initialization fee per run. |

#### 💵 Cost Calculation Examples

- **100 Search Items**: $0.15 (Subscribers: $0.09)
- **1,000 Full B2B Detail Items**: $2.50 (Subscribers: $2.00)
- **10,000 Full B2B Detail Items**: $25.00 (Subscribers: $20.00)

***

### 📦 What Data Does This Scraper Extract?

Every product record contains structured international B2B intelligence:

#### 1. Product & Pricing Intelligence

- **Product ID & Canonical URL**: Clean canonical listing link and unique ID.
- **Title**: Complete English product title.
- **Base Price & Price Range**: Exact price or min/max price range in USD.
- **Tiered Volume Pricing**: Quantity brackets with unit price discounts (e.g. `200-2999 pcs: $0.68`, `3000-29999 pcs: $0.65`, `30000+ pcs: $0.51`).
- **Minimum Order Quantity (MOQ)**: Cleanly formatted purchase threshold (e.g. `Min. order: 200 pieces`).
- **Sample Pricing**: Individual sample unit price and sample MOQ.
- **Order Count Signal**: Completed order volume indicator (e.g. `300 sold`).
- **Production Lead Times**: Staged manufacturing lead times by order volume.

#### 2. Verified Supplier & Manufacturer Intelligence

- **Supplier Legal Name**: Registered company name.
- **Origin Country**: China (CN), Vietnam (VN), India (IN), Turkey (TR), USA (US), etc.
- **Gold Supplier Tenure**: Years active on Alibaba (e.g. `9 yrs`).
- **Verified Supplier Badge**: Boolean indicator for on-site third-party factory audits (TÜV Rheinland / SGS).
- **Trade Assurance Protection**: Boolean indicator for Alibaba buyer payment guarantee.
- **Rating & Reviews**: Overall store rating score (e.g. `4.7`) and total review count.
- **Supplier Storefront URL**: Direct link to the supplier's Alibaba company profile.

#### 3. Media & Technical Specifications

- **Working HD CDN Photos**: Uncompressed, full-resolution gallery photos (`mainImage`, `pictureUrl`, `images`).
- **Full Specifications Dictionary**: Material, compatible brands, certifications, packaging details, OEM/ODM availability, and model numbers.

***

### 🛠️ Input Parameters Reference

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `keyword` | String | `"wireless earbuds"` | Product search query on Alibaba.com. |
| `categoryUrl` | String | `""` | Direct Alibaba.com category or filtered search URL. |
| `productUrls` | Array | `[]` | List of direct product URLs to scrape directly. |
| `maxItems` | Integer | `50` | Maximum number of products to extract (up to 100,000+). |
| `detailLevel` | String | `"full"` | `"full"` (tiered pricing, specs, audits, lead times) or `"summary"` (high-speed search cards). |
| `sortBy` | String | `"default"` | `"default"`, `"priceAsc"`, `"priceDesc"`, `"reviewScore"`, `"newest"`. |
| `verifiedOnly` | Boolean | `false` | Filter strictly for Verified Suppliers (TÜV/SGS audited). |
| `tradeAssuranceOnly` | Boolean | `false` | Filter strictly for suppliers supporting Trade Assurance. |
| `minOrderQuantityMax` | Integer | `null` | Filter products with MOQ less than or equal to this threshold. |
| `country` | String | `""` | Filter suppliers by origin country code (e.g. `'CN'`, `'VN'`, `'IN'`). |
| `resumptionToken` | String | `""` | Token from a previous run to resume pagination exactly where it left off. |
| `proxyConfiguration` | Object | Auto / Residential | Apify Proxy configuration for consistent, challenge-free access. |

***

### 💻 JSON Input Configurations

#### Example 1: B2B Wholesale Search with Verified Supplier Filters

Search for verified phone case manufacturers with Trade Assurance and low MOQ:

```json
{
  "keyword": "phone case",
  "maxItems": 50,
  "detailLevel": "full",
  "sortBy": "default",
  "verifiedOnly": true,
  "tradeAssuranceOnly": true,
  "minOrderQuantityMax": 200,
  "country": "CN",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

#### Example 2: Direct Product URLs Scraping

Extract complete B2B volume pricing and specs for specific Alibaba products:

```json
{
  "productUrls": [
    "https://www.alibaba.com/product-detail/Premium-Crystal-Clear-TPU-PC-Case_1601918386232.html",
    "https://www.alibaba.com/product-detail/Luxury-Lychee-Texture-Phone-Case_1601714215833.html"
  ],
  "detailLevel": "full",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

#### Example 3: High-Speed Market Discovery (`summary` mode)

Rapidly scrape 500 search listings for market overview at just $1.50 per 1,000 items:

```json
{
  "keyword": "wireless earbuds",
  "maxItems": 500,
  "detailLevel": "summary",
  "sortBy": "reviewScore",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

<p align="center">
  <a href="https://console.apify.com/actors/4lwSVTtOQcpewsKCf/input">
    <img src="https://raw.githubusercontent.com/RNFS/1688-Wholesale-Scraper-API/main/try-it-for-free.svg" width="240" height="48" alt="Try it for Free">
  </a>
  <br>
  <sub>💡 <b>Ready to extract wholesale supplier data?</b> Click above to run this configuration live in Apify Console.</sub>
</p>

***

### 📤 Sample Output Data (JSON)

Every record is formatted for immediate compatibility with databases, spreadsheets, and downstream pipelines:

```json
{
  "id": "1601918386232",
  "offerId": "1601918386232",
  "productId": "1601918386232",
  "title": "Premium Crystal Clear TPU PC Case for iPhone 17 18 Pro Max Strong Magnetic Charging Shockproof Transparent Phone Cover",
  "url": "https://www.alibaba.com/product-detail/Premium-Crystal-Clear-TPU-PC-Case_1601918386232.html",
  "productUrl": "https://www.alibaba.com/product-detail/Premium-Crystal-Clear-TPU-PC-Case_1601918386232.html",
  "price": 0.68,
  "priceMin": 0.7251,
  "priceMax": 0.9667,
  "currency": "USD",
  "minOrderQuantity": "Min. order: 200 pieces",
  "soldOrder": "300 sold",
  "tieredPrices": [
    { "minQuantity": 200, "maxQuantity": 2999, "price": 0.68, "unit": "piece" },
    { "minQuantity": 3000, "maxQuantity": 29999, "price": 0.65, "unit": "piece" },
    { "minQuantity": 30000, "maxQuantity": null, "price": 0.51, "unit": "piece" }
  ],
  "supplier": {
    "name": "Guangzhou Ruite Electronic Technology Co., Ltd.",
    "country": "CN",
    "yearsActive": "9 yrs",
    "isVerified": true,
    "tradeAssurance": true,
    "rating": 4.7,
    "reviewCount": 99,
    "storeUrl": "https://ruitetec.en.alibaba.com/company_profile.html"
  },
  "mainImage": "https://sc04.alicdn.com/kf/He0c23016d3854f688506c3d7090724e8a.png",
  "pictureUrl": "https://sc04.alicdn.com/kf/He0c23016d3854f688506c3d7090724e8a.png",
  "images": [
    "https://sc04.alicdn.com/kf/He0c23016d3854f688506c3d7090724e8a.png",
    "https://sc04.alicdn.com/kf/H0905779a61dc41c7a3122237ebd3af61u.jpg"
  ],
  "leadTime": {
    "ladderPeriodList": [
      { "minQuantity": 1, "maxQuantity": 100, "processPeriod": 8 },
      { "minQuantity": 101, "maxQuantity": 1000, "processPeriod": 12 },
      { "minQuantity": 1001, "maxQuantity": 5000, "processPeriod": 16 }
    ]
  },
  "specifications": {
    "compatible brand": "For iPhone, For Samsung",
    "design style": "Transparent",
    "material": "TPU+PC",
    "feature": "360 protection, Anti-Fingerprint, Magnetic, Shockproof",
    "OEM/ODM": "Warmly Welcomed"
  },
  "detailLevel": "full",
  "page": 1,
  "position": 1,
  "nextPage": 2,
  "resumptionToken": "gAAAAABqs8yqOTyY..."
}
```

***

### ❓ Frequently Asked Questions (FAQ)

#### Can I export the data to Microsoft Excel or Google Sheets?

**Yes.** Once your run finishes, click the **Export** button in the Apify Console. You can download the dataset directly as **Excel (.xlsx)**, **CSV**, **JSON**, or connect it via live API to **Google Sheets**, **Airtable**, or **Make / Zapier**.

#### How do Verified Suppliers differ from regular suppliers?

Verified Suppliers on Alibaba.com have undergone an extensive on-site inspection and audit by world-renowned third-party certification bodies (**TÜV Rheinland** or **SGS**). Their company registration, production capabilities, quality control processes, and facilities are independently confirmed.

#### What is the difference between `summary` and `full` detail modes?

- **`summary` mode** ($1.50 / 1k): Fast extraction of search card listings (title, price range, MOQ, supplier overview, preview photo). Ideal for broad market research and keyword indexing.
- **`full` mode** ($2.50 / 1k): Visits each product listing to extract tiered volume pricing brackets, detailed specifications, lead times, sample pricing, and verified supplier certifications. Ideal for direct purchasing, margin modeling, and supplier due diligence.

#### How does pagination resumption work?

Every output record contains a `resumptionToken`. If you need to stop a run and continue later, simply copy the `resumptionToken` from your latest result and paste it into the Actor input under `resumptionToken`. The scraper will resume from that exact page without re-scraping existing items.

***

<p align="center">
  <b>Built for professional importers, e-commerce sellers, and procurement teams worldwide.</b>
</p>

# Actor input Schema

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

Enter the product keyword to search on Alibaba.com (e.g., 'wireless earbuds', 'leather jacket', 'yoga mat').

## `categoryUrl` (type: `string`):

Direct Alibaba.com search or category listing URL to scrape (e.g., 'https://www.alibaba.com/trade/search?SearchText=phone+case').

## `productUrls` (type: `array`):

List of direct Alibaba.com product URLs to scrape directly (e.g., 'https://www.alibaba.com/product-detail/Wholesale-Earbuds\_1600123456789.html').

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

Maximum number of wholesale products to extract.

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

'summary' extracts product search cards ($1.50/1k). 'full' fetches complete B2B wholesale pricing tiers, MOQ, supplier audits (TÜV/SGS), lead times, and specifications ($2.50/1k).

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

Sort order for search listings.

## `verifiedOnly` (type: `boolean`):

Filter strictly for Verified Suppliers on Alibaba.com (on-site audited by TÜV Rheinland / SGS).

## `tradeAssuranceOnly` (type: `boolean`):

Filter strictly for suppliers supporting Alibaba Trade Assurance buyer payment protection.

## `minOrderQuantityMax` (type: `integer`):

Filter for products with Minimum Order Quantity (MOQ) less than or equal to this number.

## `country` (type: `string`):

Filter suppliers by origin country code (e.g. 'CN' for China, 'VN' for Vietnam, 'IN' for India, 'TR' for Turkey, 'US' for USA). Leave empty for all countries.

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

Encrypted session token from a previous run to resume pagination exactly where it left off.

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

Apify Proxy configuration. Residential proxies or dedicated proxy groups (e.g., BUYPROXIES94952) are strongly recommended to prevent anti-bot challenges.

## Actor input object example

```json
{
  "keyword": "wireless earbuds",
  "maxItems": 50,
  "detailLevel": "full",
  "sortBy": "default",
  "verifiedOnly": false,
  "tradeAssuranceOnly": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

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

Extracted Alibaba.com B2B wholesale offers, tiered pricing, and verified supplier audits

# 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": "wireless earbuds",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraperpro/alibaba-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": "wireless earbuds",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("scraperpro/alibaba-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": "wireless earbuds",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call scraperpro/alibaba-wholesale-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scraperpro/alibaba-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/4lwSVTtOQcpewsKCf/builds/KWpx07ycrwfjkvWnL/openapi.json
