# Alibaba.com Scraper 📦 $1/1k (`123webdata/alibaba-scraper`) Actor

$1/1k 💰 | Fast ⚡️ | Quick Support 🚀 | Scrape Alibaba.com search and product pages; get tiered prices and minimum orders, supplier names, product descriptions, and full-size product images. Export JSON or CSV for wholesale sourcing and market research.

- **URL**: https://apify.com/123webdata/alibaba-scraper.md
- **Developed by:** [Milán Vásárhelyi](https://apify.com/123webdata) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.89 / 1,000 results

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

## Alibaba Scraper

Collect structured wholesale product, pricing, minimum-order, seller, and image data from Alibaba.com product and search URLs.

### Issues and feature requests

If you encounter an issue or need a field added, open an issue on the Actor page or write to hello@123webdata.com.

### Output Example (simplified)

The overview shows the most useful fields in a table. Product images are displayed as thumbnails when the website provides them.

| Image | Product URL | Product ID | Product name | Current price | Maximum price | Minimum order | Order unit | Currency | Seller | Scraped at |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| <img src="https://sc04.alicdn.com/kf/Hc34089a7e9a64b63a2df81a5276812963.jpg" style="max-width: 100px; max-height: 100px; object-fit: contain;"> | https://www.alibaba.com/product-detail/Bluetooth-Headphones-Wholesale-Wireless-Sports-Earphones\_1600306618819.html | 1600306618819 | Bluetooth Headphones Wholesale Wireless Sports Earphones Headphones Wireless Bluetooth 5.4 Tws Noise Cancelling Gaming Earphone - Buy Product on Alibaba.com | 6.5 | 7.3 | 10 | pieces | USD | Shenzhen Xiangxiangyu Technology Co., Ltd. | 2026-08-21T00:00:00.000Z |

### How to scrape supported list pages

This Actor accepts individual product links in `productUrls`. It accepts search result pages in `categoryUrls`.

1. Open a supported list page in your browser.
2. Run a search you need.
3. Copy the final URL from the address bar and paste it into `categoryUrls`.

The Actor follows the products shown on that page.

### Features

- Scrapes detailed wholesale product and supplier information from Alibaba.com product pages
- Accepts individual product URLs and search result pages
- Lets you limit the number of saved products and choose whether to continue through additional result pages
- Returns structured tiered prices and minimum orders, supplier names, product descriptions, and full-size product images for viewing, export, and analysis

### Pricing

This Actor uses pay-per-event pricing. Its running costs are included.

- **Actor start:** $0.03 once per run — One fixed charge for starting a run.
- **Result:** $0.00099 each ($0.99 per 1,000) — A product record collected directly from a supported list page.
- **Product detail:** $0.00399 each ($3.99 per 1,000) — A full product record collected from its product page.

The start charge applies once per run. Each saved product is charged either as a Result or a Product detail, never both.

| Results in one run | Result | Product detail |
| ---: | ---: | ---: |
| 100 | $0.13 | $0.43 |
| 1,000 | $1.02 | $4.02 |

[Apify's Free plan](https://apify.com/pricing) currently includes $5 in monthly usage credits. If the full $5 is available for this Actor, one run covers about 5,020 Results or 1,245 Product details. Other Apify usage reduces the available credit.

### Input

The Actor accepts the following input parameters:

| Field | Type | Description |
| --- | --- | --- |
| `productUrls` | array | Product URLs to scrape |
| `categoryUrls` | array | Supported list pages: search result pages |
| `maxResultsPerScrape` | integer | Maximum number of product records to save |
| `usePagination` | boolean | Whether to continue through additional result pages |
| `scrapeProductDetails` | boolean | Enabled returns Product detail records with the product-page fields listed below. Disabled returns Result records with the list-level fields. |

### What data you get in each mode

Every saved product is stored as one record. `scrapeProductDetails` decides which mode you receive; the lists below name every field each mode can return. A field is empty when the website does not show that information.

#### Result

A list-level product record with 16 declared fields:

`url`, `product_id`, `name`, `price`, `max_price`, `minimum_order_quantity`, `minimum_order_unit`, `currency`, `sku`, `main_image`, `images`, `seller_url`, `canonical_url`, `supplier_years`, `supplier_country`, `badges`

#### Product detail

A full product record with 25 declared fields:

`url`, `product_id`, `name`, `price`, `max_price`, `minimum_order_quantity`, `minimum_order_unit`, `currency`, `sku`, `mpn`, `main_image`, `images`, `description`, `description_html`, `attributes`, `rating_value`, `review_count`, `seller_name`, `seller_url`, `canonical_url`, `scraped_at`, `sold_count`, `supplier_years`, `supplier_country`, `badges`

### Output Example (full)

The Actor stores one structured record per product. Card-only records contain only fields available on the list; detail-only fields are omitted.

```json
{
  "url": "https://www.alibaba.com/product-detail/Bluetooth-Headphones-Wholesale-Wireless-Sports-Earphones_1600306618819.html",
  "product_id": "1600306618819",
  "name": "Bluetooth Headphones Wholesale Wireless Sports Earphones Headphones Wireless Bluetooth 5.4 Tws Noise Cancelling Gaming Earphone - Buy Product on Alibaba.com",
  "price": 6.5,
  "max_price": 7.3,
  "minimum_order_quantity": 10,
  "minimum_order_unit": "pieces",
  "currency": "USD",
  "sku": "1600306618819",
  "mpn": "1600306618819-00",
  "main_image": "https://sc04.alicdn.com/kf/Hc34089a7e9a64b63a2df81a5276812963.jpg",
  "images": [
    "https://sc04.alicdn.com/kf/Hc34089a7e9a64b63a2df81a5276812963.jpg",
    "https://sc04.alicdn.com/kf/H06ec846c9ea84f9883aa34867fb36349F.jpg",
    "https://sc04.alicdn.com/kf/He33f8717f89448018f0f606259e35each.jpg",
    "https://sc04.alicdn.com/kf/H215b4c46eeb645e68d11ab342b4d4f61T.jpg",
    "https://sc04.alicdn.com/kf/H696db869dcc9418ba2f230c69229e8bdy.jpg",
    "https://sc04.alicdn.com/kf/H79afb5163c5e480c8e629748f04e3256f.jpg"
  ],
  "description": "Bluetooth Headphones Wholesale Wireless Sports Earphones Headphones Wireless Bluetooth 5.4 TWS Noise Cancelling Gaming Earphone",
  "description_html": "<p>Bluetooth Headphones Wholesale Wireless Sports Earphones Headphones Wireless Bluetooth 5.4 TWS Noise Cancelling Gaming Earphone</p>",
  "attributes": {
    "model number": [
      "XY-19"
    ],
    "color": [
      "White",
      "Black"
    ],
    "noise cancelling": "Environmental Noise Cancellation (ENC)",
    "BT Wireless": "Bluetooth v5.4",
    "private mold": "Yes",
    "Estimated Battery Life": "more than 20 hours",
    "chipset": "JL",
    "Sound Quality": "High Fidelity (Hi-Fi), Stereo"
  },
  "rating_value": 5,
  "review_count": 6,
  "seller_name": "Shenzhen Xiangxiangyu Technology Co., Ltd.",
  "canonical_url": "https://www.alibaba.com/product-detail/Bluetooth-Headphones-Wholesale-Wireless-Sports-Earphones_1600306618819.html",
  "scraped_at": "2026-08-21T00:00:00.000Z",
  "sold_count": 371
}
```

### Use Cases

- Compare wholesale price tiers and minimum orders
- Research products and suppliers
- Build structured sourcing and catalog datasets

### Integrate with AI and automation

#### Use with AI through MCP

Connect your AI assistant to the [Apify MCP server](https://docs.apify.com/integrations/mcp). It can discover and run Actors, then access the results in the same conversation. For example, ask your assistant to scrape a list of products from Alibaba.com, compare prices, or summarize the collected data.

#### Run on a schedule

After one successful run, use [Apify Schedules](https://docs.apify.com/actors/running/schedules) to repeat the same task hourly, daily, weekly, or with a custom cron schedule. Saved tasks are useful when you want to keep the same URLs and settings for every run.

#### Connect with n8n

[Create an n8n account](https://n8n.partnerlinks.io/ezvl1qy3f990) and add the verified Apify node to a workflow. Choose **Run an Actor and Get Dataset** when the workflow should start this Actor, wait for completion, and receive the product rows for the next node. See the [Apify integration for n8n](https://n8n.io/integrations/apify/).

#### Connect with Make

[Create a Make account](https://www.make.com/en/register?pc=vasarmilan) and add the Apify **Run an Actor** module. Follow it with **Get Dataset Items** to pass the product rows to Google Sheets, a database, email, or another Make module. For longer runs, use **Watch Actor Runs** followed by **Get Dataset Items**.

[Read the Make integration guide](https://docs.apify.com/integrations/make).

# Actor input Schema

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

Product URLs on Alibaba.com.

## `categoryUrls` (type: `array`):

Category URLs on Alibaba.com.

## `maxResultsPerScrape` (type: `integer`):

Maximum number of product records to save.

## `usePagination` (type: `boolean`):

Enqueue the bounded pagination lookahead exposed by this actor.

## `scrapeProductDetails` (type: `boolean`):

Enabled returns Product detail records with the product-page fields listed in the README. Disabled returns Result records with the list-level fields.

## Actor input object example

```json
{
  "productUrls": [
    "https://www.alibaba.com/product-detail/Bluetooth-Headphones-Wholesale-Wireless-Sports-Earphones_1600306618819.html"
  ],
  "categoryUrls": [
    "https://www.alibaba.com/trade/search?SearchText=headphones&tab=all"
  ],
  "maxResultsPerScrape": 20,
  "usePagination": true,
  "scrapeProductDetails": true
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# 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 = {
    "productUrls": [
        "https://www.alibaba.com/product-detail/Bluetooth-Headphones-Wholesale-Wireless-Sports-Earphones_1600306618819.html"
    ],
    "categoryUrls": [
        "https://www.alibaba.com/trade/search?SearchText=headphones&tab=all"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("123webdata/alibaba-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 = {
    "productUrls": ["https://www.alibaba.com/product-detail/Bluetooth-Headphones-Wholesale-Wireless-Sports-Earphones_1600306618819.html"],
    "categoryUrls": ["https://www.alibaba.com/trade/search?SearchText=headphones&tab=all"],
}

# Run the Actor and wait for it to finish
run = client.actor("123webdata/alibaba-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 '{
  "productUrls": [
    "https://www.alibaba.com/product-detail/Bluetooth-Headphones-Wholesale-Wireless-Sports-Earphones_1600306618819.html"
  ],
  "categoryUrls": [
    "https://www.alibaba.com/trade/search?SearchText=headphones&tab=all"
  ]
}' |
apify call 123webdata/alibaba-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,123webdata/alibaba-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/9U3zcbJVmePe3BE7A/builds/KoQjsq6B1oI6AQXyt/openapi.json