# Alibaba Supplier Scraper & API - Store Catalogs, MOQ, Prices (`rel8ble/alibaba-supplier-store-scraper`) Actor

Alibaba supplier scraper: every product an Alibaba supplier store lists, by store URL, product URL or keyword. One result = one product: price, MOQ, certificates, sold count, store category, plus supplier verification, rating, years, staff, rankings and capabilities. $1.00 per 1,000, no start fee.

- **URL**: https://apify.com/rel8ble/alibaba-supplier-store-scraper.md
- **Developed by:** [Giovanni Rich](https://apify.com/rel8ble) (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

$1.00 / 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.

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 Supplier Scraper & API - Store Catalogs, MOQ, Prices

This **Alibaba supplier scraper** downloads the **entire product catalog of any Alibaba.com supplier** (their storefront at `name.en.alibaba.com`) into clean JSON, CSV or Excel rows: every product with **price range, MOQ, certificates, units sold in 180 days, orders, ready-to-ship flag and the supplier's own store category**, plus the **supplier card** on every row: company name, country and address, business type, supplier identity, years on Alibaba, verified staff count, store rating, verification company (TÜV, SGS, Intertek ...), ranking badges, main products and verified capabilities (ODM, patents, annual export).
Use it as an **Alibaba store scraper**, an **Alibaba supplier store scraper**, an **Alibaba supplier products scraper** for factory due diligence and competitor catalogs, or an unofficial **Alibaba supplier API** from your own code, Make, Zapier or n8n.

Give it store URLs, store names, product URLs (it finds the supplier) or plain keywords (it finds the suppliers behind the search). It reads the data the storefront itself renders, over plain HTTP, with **no headless browser and no login**. 150 products from 6 stores take about 20 seconds.

### What you get

- **Product**: product ID, title, product URL, main image and gallery images, colour swatches, the supplier's own store category (with parent), position in the store.
- **Price & MOQ**: price from / to, price text and unit, currency, MOQ and unit, ready-to-ship, free shipping and quick-dispatch flags.
- **Demand & compliance**: units sold in the last 180 days and orders (when Alibaba shows them), product rating, certificates on the card (CE, FCC, RoHS, UKCA ...).
- **Supplier** (same on every row of a store): company name and ID, storefront, all-products and profile links, country, province, location and verified operational address, business type (manufacturer / trading company), supplier identity (e.g. Custom Manufacturer), years on Alibaba, verified staff count, store rating, gold / verified / Trade Assurance flags, inspection company, ranking badges ("#2 best seller in ..."), main products, capability tags, annual export value, logo, total products in the store.

No personal contact details are collected: no contact person names, phone numbers or emails.

### Sample output

Real rows from a test run (two stores given directly, one store found from a product URL, three found by the search `bluetooth speaker`), a few of the 55 fields:

| title | price | MOQ | sold 180d | store category | supplier | years | rating | source |
|---|---|---|---|---|---|---|---|---|
| ALOVA Air Conduction Headphone With All Key Features... | $9.30-15 / piece | 1 piece | 10 | Open Ear Headphone > Call Center Headset | Shenzhen Alex Technology Co., Ltd. | 11 | 4.5 | store |
| Suede Yoga Mat Custom Print Microfiber Yoga Mat... | $12.35-12.50 / piece | 30 pieces | 0 | Yoga > Yoga Mat | Guangzhou Umicca Sport Products Co., Ltd. | 4 | 4.8 | store |
| High Quality PU Yoga Mat Custom Logo Non-Slip... | $11.56-12.49 / piece | 10 pieces | 92 | Hot Products | Dongguan Jiuzilong Industrial Co., Ltd | 3 | 4.9 | productUrl |
| HM11 Retro Bluetooth Speaker, Vintage Decor... | $3.89-4.49 / piece | 2 pieces | 4 | Bluetooth Speaker | Shenzhen Yuzhuo Technology Co., Ltd. | 13 | 4.4 | search |
| Portable IPX7 Waterproof Rechargeable Wireless... | $12.80-13.20 / piece | 1000 pieces | 0 | Consumer Electronic > Bluetooth Speaker | MANOVA INTERNATIONAL LIMITED | 7 | 4.8 | search |

### Use cases

- **Supplier due diligence**: see everything a factory sells, how it is organised, what is certified and what actually sells, before you send an inquiry
- **Supplier shortlists and B2B lead lists**: search a keyword, scrape the top suppliers' stores, compare staff, years, rating, verification and capabilities side by side
- **Competitor and market research**: track a competitor's supplier catalog, new listings (newest first) and price ranges over time
- **Private label and dropshipping sourcing**: pull a whole category of a trusted supplier with images, MOQ and ready-to-ship flags
- **Price monitoring**: schedule runs to watch price ranges and MOQ across the stores you buy from

### Pricing

**$1.00 per 1,000 products** (pay per result; one result = one product saved). **No start fee.** Products skipped by your filters, duplicates, missing stores, invalid inputs and failed requests are never charged.

| You scrape | You pay |
|---|---|
| 100 products | $0.10 |
| 1,000 products | $1.00 |
| 10,000 products | $10.00 |
| 100,000 products | $100.00 |

The Apify free plan's $5 monthly credit covers about 5,000 products. The prefilled input (one store, 20 products) costs $0.02 and finished in 5 seconds in a cloud test; 150 products from 6 stores took 23 seconds. Platform usage is small because no browser runs. If you set a maximum cost per run, the scraper stops cleanly when it reaches it.

#### Why this one

- **Cheapest full-catalog Alibaba supplier scraper** on the Store: the other supplier scrapers charge $1.20-$7.00 per 1,000, several with a start fee on top; general Alibaba scrapers charge $2.00-$5.00.
- **Supplier profile on every row**: verification company (TÜV, SGS, Intertek), years on Alibaba, staff count, store rating, ranking badges, capabilities and annual export, next to each product.
- **Whole catalogs, not just search hits**: up to 4,000 products per store, with the supplier's own store categories, newest first.
- **Three ways in**: store URL or name, any product URL (its supplier is found), or a keyword (the suppliers behind the search).
- **Fast and light**: plain HTTP, no browser, no login.

### FAQ

**Does it need a browser, cookies or an Alibaba account?**
No. Plain HTTPS requests to the public storefront pages, no login.

**Which proxy should I use?**
None: leave the default. The actor connects directly and retries any blocked request through Apify Proxy automatically (datacenter, then residential).

**Can I scrape just one category of a store?**
Yes: open the category on the supplier's storefront and paste that URL (it contains `productgrouplist-`).

**How is this different from the Alibaba search scraper?**
The search scraper finds products across all suppliers for a keyword. This actor goes the other way: it lists everything one supplier sells, with the supplier's verified profile on every row.

**What happens with a store that does not exist?**
It is listed in `RUN_SUMMARY` as not found and is not charged.

**How much does a whole store cost?**
A typical 300-product supplier store is $0.30. Set **Max products per store** to 0 for the full catalog (up to 4,000 products).

**Are contact names, phone numbers or emails included?**
No. Only the public company profile is collected, no personal contact details.

### How to use

1. Paste supplier stores into **Supplier stores**, one per line: `https://alextechnology.en.alibaba.com/` (any page of the store), just `alextechnology`, a store category URL to scrape one category, or any Alibaba product URL (its supplier's store is scraped).
2. Or type keywords into **Find stores by keyword** (e.g. `bluetooth speaker`): the actor searches Alibaba, takes the suppliers behind the results (up to **Max stores per search**) and scrapes their stores.
3. Set **Max products per store** (0 = the whole catalog), optionally a **Keyword inside each store**, ready-to-ship only, or price / MOQ filters.
4. Click **Start** and download the results from the **Output** tab, or fetch them through the Apify API.

### Input

| Field | Default | Description |
|---|---|---|
| `storeUrls` | - | Store URLs (any page), store names (`alextechnology`), store category URLs, or Alibaba product URLs |
| `searchTerms` | - | Keywords or alibaba.com search URLs; the suppliers behind the results are scraped |
| `maxStoresPerSearch` | 5 | Supplier stores taken per search term (1-100) |
| `maxProductsPerStore` | 100 | Products per store or category. 0 = whole catalog (up to 4,000) |
| `keywordInStore` | - | Search inside every store, e.g. `earphone` |
| `readyToShipOnly` | false | Only ready-to-ship products |
| `minPrice` / `maxPrice` / `maxMoq` | - | Filters, applied before charging |

With no input at all, a 20-product demo store runs.

### Input example

```json
{
    "storeUrls": [
        "https://alextechnology.en.alibaba.com/productlist.html",
        "verchoo",
        "https://www.alibaba.com/product-detail/High-Quality-PU-Yoga-Mat-Custom_1601669249206.html"
    ],
    "searchTerms": ["bluetooth speaker"],
    "maxStoresPerSearch": 3,
    "maxProductsPerStore": 25,
    "maxPrice": 30
}
```

### Output example

```json
{
    "productId": "1601240924267",
    "title": "HM11 Retro Bluetooth Speaker, Vintage Decor, Mini Wireless Bluetooth Speaker, Fashion Style Outdoor Accessories",
    "url": "https://www.alibaba.com/product-detail/HM11-Retro-Bluetooth-Speaker-Vintage-Decor_1601240924267.html",
    "image": "https://sc04.alicdn.com/kf/H5e1552e59d944d3c8e9051b72efacfe1F/HM11-Retro-Bluetooth-Speaker-Vintage-Decor-Mini.jpg",
    "priceMin": 3.89,
    "priceMax": 4.49,
    "priceText": "$3.89-4.49 / piece",
    "currency": "USD",
    "priceUnit": "piece",
    "moq": 2,
    "moqUnit": "pieces",
    "readyToShip": true,
    "certificates": ["FCC", "DECLARATION OF CONFORMITY"],
    "soldLast180Days": 4,
    "orderCount": 3,
    "storeCategory": "Bluetooth Speaker",
    "colorSwatches": ["#000000", "#0000FF", "#00FF00", "#ffc0cb"],
    "supplierName": "Shenzhen Yuzhuo Technology Co., Ltd.",
    "supplierId": "231401697",
    "storeUrl": "https://szyz.en.alibaba.com/",
    "supplierCountryCode": "CN",
    "supplierLocation": "Guangdong, China",
    "supplierBusinessType": ["Trading Company"],
    "supplierIdentity": "Multispecialty Supplier",
    "supplierYearsOnAlibaba": 13,
    "supplierStaffCount": 8,
    "supplierRating": 4.4,
    "goldSupplier": true,
    "verifiedSupplier": true,
    "supplierVerifiedBy": "SGS Group",
    "tradeAssurance": true,
    "supplierMainProducts": ["Bluetooth Headphone", "Bluetooth Speaker", "Wireless Charger", "Portable Fan"],
    "supplierCapabilities": ["Registered trademarks (3)", "Finished product inspection", "Patents awarded (2)", "ODM services available", "Full customization"],
    "storeTotalProducts": 271,
    "storePage": 1,
    "storePosition": 1,
    "source": "search",
    "searchTerm": "bluetooth speaker",
    "scrapedAt": "2026-10-25T17:36:01.714Z"
}
```

(Shortened: every row also has the gallery images, store category ID, free-shipping and quick-dispatch flags, product rating, profile and all-products links, province, address, ranking badges, annual export and logo.)

The dataset has three views: **Overview**, **Suppliers** and **Catalog order**. The `RUN_SUMMARY` record lists per store how many products it has, how many were saved and why it stopped, the stores each search found, and any store that was not found.

### API example

Python (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("rel8ble/alibaba-supplier-store-scraper").call(run_input={"storeUrls": ["alextechnology"], "maxProductsPerStore": 100})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["title"], "|", item.get("priceText"), "|", item.get("moq"), "|", item.get("supplierName"))
```

One HTTP call that runs the actor and returns the rows (curl):

```bash
curl -X POST "https://api.apify.com/v2/acts/rel8ble~alibaba-supplier-store-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>"   -H "Content-Type: application/json"   -d '{"searchTerms": ["bluetooth speaker"], "maxStoresPerSearch": 3, "maxProductsPerStore": 20}'
```

### Integrations

- **Our Alibaba search scraper**: search a keyword there, filter by price / MOQ / country, then pass the `supplierUrl` column here for each supplier's full catalog.
- **Our Alibaba Product Details Scraper**: pass the `url` column of the products you like for full price ladders, SKUs, specs and lead times.
- **Make, Zapier and n8n**: run the actor and pass the products on to any app.
- **Google Sheets**: export the dataset straight to a spreadsheet.
- **Apify API**: start runs and download results over REST, or with the JavaScript and Python clients.
- **Webhooks**: get notified when a run finishes.
- **MCP for AI agents**: the Apify MCP server (https://mcp.apify.com) lets Claude, ChatGPT, Cursor and other agents call this Alibaba store scraper as a tool.

### Limits

- **Listing-level data.** Store cards carry price range, MOQ, certificates and sales counts; full quantity price ladders, SKUs and specifications are on the product page (use our Alibaba Product Details Scraper for those).
- **Sales and rating fields depend on the product.** In a 150-product test, sold-in-180-days and order counts were filled on about a third of products, product rating on 10%. Supplier rating, years, business type and verification were on every row; staff count, identity and capability tags on about two thirds; ranking badges on about a third; annual export on about one in six.
- **Up to 4,000 products per store** (250 pages of 16), newest first. For bigger stores, scrape by store category or keyword.
- **Prices** are the list prices the store shows (USD for almost all suppliers).
- **Stores found by keyword** come from the first search pages, sponsored listings included, so a few may sell something adjacent to your keyword.

# Actor input Schema

## `storeUrls` (type: `array`):

Supplier storefronts to scrape, one per line: https://alextechnology.en.alibaba.com/ (any page of the store works), just the store name alextechnology, or a store category URL (.../productgrouplist-818986374/Open_Ear_Headphone.html) to scrape one category only. An Alibaba product URL also works: its supplier store is scraped. Tip: feed it the supplierUrl column from our Alibaba search scraper.

## `searchTerms` (type: `array`):

Optional. Keywords (e.g. "yoga mat") or alibaba.com search URLs. The scraper searches Alibaba, takes the suppliers behind the results (up to Max stores per search) and scrapes their stores. Leave empty when you give stores directly. With no input at all, a 20-product demo store runs.

## `maxStoresPerSearch` (type: `integer`):

Optional, search terms only. Supplier stores taken per search term, integer 1-100. Default 5.

## `maxProductsPerStore` (type: `integer`):

Optional. Products saved per store (or per store category), integer >= 0. Default 100; 0 = the whole catalog (up to 4,000 per store). You pay per product, so start small.

## `keywordInStore` (type: `string`):

Optional. Search inside every store for this word (e.g. "earphone") and only return matching products. Leave empty for the whole catalog.

## `readyToShipOnly` (type: `boolean`):

Optional boolean. true = only products Alibaba marks ready to ship (in stock, fixed price, fast dispatch). Default false.

## `minPrice` (type: `number`):

Optional filter. Skip products whose highest price is below this. Skipped products are not charged.

## `maxPrice` (type: `number`):

Optional filter. Skip products whose lowest price is above this. Skipped products are not charged.

## `maxMoq` (type: `integer`):

Optional filter. Skip products whose minimum order quantity is above this. Skipped products are not charged.

## `maxConcurrency` (type: `integer`):

Optional, advanced. Parallel requests, integer 1-20. Default 5. Leave unset.

## `maxRequestRetries` (type: `integer`):

Optional, advanced. Retries per failed or blocked request, integer 0-20; each retry uses a new session. Default 6.

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

Optional, advanced. Leave as is. Default {"useApifyProxy": false} = automatic: direct connection first, and only requests that get blocked are retried through Apify Proxy (datacenter, then residential). Set your own Apify Proxy groups or proxy URLs to force them for every request.

## Actor input object example

```json
{
  "storeUrls": [
    "https://alextechnology.en.alibaba.com/productlist.html"
  ],
  "maxStoresPerSearch": 5,
  "maxProductsPerStore": 20,
  "readyToShipOnly": false,
  "maxConcurrency": 5,
  "maxRequestRetries": 6,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `products` (type: `string`):

One row per product in the supplier stores: price, MOQ, certificates, sold counts, store category and the supplier card.

## `summary` (type: `string`):

Counts per store and per search, filtered products and any failed requests.

# 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 = {
    "storeUrls": [
        "https://alextechnology.en.alibaba.com/productlist.html"
    ],
    "maxProductsPerStore": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("rel8ble/alibaba-supplier-store-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 = {
    "storeUrls": ["https://alextechnology.en.alibaba.com/productlist.html"],
    "maxProductsPerStore": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("rel8ble/alibaba-supplier-store-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 '{
  "storeUrls": [
    "https://alextechnology.en.alibaba.com/productlist.html"
  ],
  "maxProductsPerStore": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call rel8ble/alibaba-supplier-store-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rel8ble/alibaba-supplier-store-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/Z5Xx3AM5mpCMTr0uu/builds/7Vz5kuYfTk27Ae9vv/openapi.json