# Alibaba Products and Suppliers Scraper (`fetch_cat/alibaba-products-suppliers-scraper`) Actor

Export Alibaba products with prices, MOQ, supplier names, storefronts, locations, verification signals, images, and source URLs.

- **URL**: https://apify.com/fetch\_cat/alibaba-products-suppliers-scraper.md
- **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community)
- **Categories:** E-commerce, Marketing, Automation
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.10 / 1,000 product 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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Alibaba Products and Suppliers Scraper

Alibaba Products and Suppliers Scraper extracts Alibaba.com product search results for e-commerce sourcing, supplier discovery, price/MOQ research, and product lead exports.

### Value proposition

Get structured Alibaba product search data without manually copying result cards.

### What does this actor do?

Alibaba Products and Suppliers Scraper exports product results from Alibaba.com for sourcing, supplier discovery, and product research. Each dataset row contains product titles, Alibaba product URLs, price text, MOQ/minimum order text, supplier signals, images, and the source query.

### Who is it for and use cases

- **Sourcing teams:** build a shortlist of products and suppliers for buyer outreach.
- **E-commerce researchers:** compare visible price ranges, MOQ text, and product positioning.
- **Market analysts:** monitor Alibaba search results for recurring product categories.
- **Lead generation teams:** collect product URLs and supplier names for follow-up workflows.

### Input example

```json
{
  "queries": ["solar panel", "yoga mat"],
  "maxItemsPerQuery": 10,
  "maxRetriesPerQuery": 1
}
```

### Input recipes

- Search `solar panel` to compare visible prices, MOQ, and supplier signals.
- Search `yoga mat` to export a second target-bound sourcing dataset.

### Input settings

| Field | Type | Description |
| --- | --- | --- |
| `queries` | string\[] | Alibaba search phrases to run. |
| `maxItemsPerQuery` | integer | Maximum product rows to save per query. |
| `navigationTimeoutMs` | integer | Bounded timeout for fallback browser navigation. |
| `maxRetriesPerQuery` | integer | Retries for transient empty or blocked browser pages. |
| `proxyConfiguration` | object | Apify Proxy settings. Residential proxy is recommended when the browser fallback is needed. |

### Output example

```json
{
  "query": "solar panel",
  "rank": 1,
  "title": "Bluesun Solar Panel 700w 710w 720w Best Panel Bifacial Solar Panel",
  "url": "https://www.alibaba.com/product-detail/example_1600000000000.html",
  "priceText": "$61.2 - $63.36",
  "moqText": null,
  "supplierName": "Bluesun Solar Co., Ltd.",
  "supplierLocation": "China",
  "verifiedSupplier": true,
  "tradeAssurance": false,
  "imageUrl": "https://s.alicdn.com/example.jpg",
  "sourceUrl": "https://open-s.alibaba.com/openservice/...",
  "scrapedAt": "2026-07-24T21:55:08.000Z"
}
```

### Output fields

| Field | Description |
| --- | --- |
| `query` | Input search phrase that produced the row. |
| `rank` | Rank within the extracted results for that query. |
| `title` | Product title. |
| `url` | Alibaba product detail URL when available. |
| `priceText` | Visible price or price range text when available. |
| `moqText` | MOQ/minimum order text when available. |
| `supplierName` | Supplier name when available. |
| `supplierUrl` | Alibaba supplier storefront/profile URL when available. |
| `supplierLocation` | Supplier country/location signal when available. |
| `supplierYears` | Visible Alibaba membership duration when available. |
| `supplierResponseTime` | Visible supplier response-time signal when available. |
| `verifiedSupplier` | Whether the record contains verified supplier signals. |
| `tradeAssurance` | Whether trade assurance is detected. |
| `imageUrl` | Product image URL when available. |
| `sourceUrl` | Source URL or service endpoint used for extraction. |
| `scrapedAt` | ISO timestamp when the row was saved. |

### API usage: Alibaba products and suppliers API

Use the Alibaba products and suppliers API examples below to start runs and retrieve datasets programmatically.

#### Node.js

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

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/alibaba-products-suppliers-scraper').call({
  queries: ['solar panel'],
  maxItemsPerQuery: 10,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### Python

```python
from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/alibaba-products-suppliers-scraper').call(run_input={
    'queries': ['solar panel'],
    'maxItemsPerQuery': 10,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)
```

#### cURL

```bash
curl -X POST "https://api.apify.com/v2/acts/fetch_cat~alibaba-products-suppliers-scraper/runs?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"queries":["solar panel"],"maxItemsPerQuery":10}'
```

### MCP and AI agents

Use this actor from Apify MCP-compatible tools to give AI agents Alibaba product search data. Start with narrow queries and low `maxItemsPerQuery` values, then increase limits after checking result quality.

Claude CLI setup example:

```bash
claude mcp add apify -- npx -y @apify/actors-mcp-server --actors fetch_cat/alibaba-products-suppliers-scraper
```

MCP JSON config example:

```json
{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server", "--actors", "fetch_cat/alibaba-products-suppliers-scraper"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}
```

Example prompts:

- "Find 10 Alibaba solar panel product results and summarize common supplier signals."
- "Export Alibaba yoga mat product URLs with price and MOQ text."
- "Compare visible Alibaba search results for phone cases and screen protectors."

### Pricing

This actor uses pay-per-event pricing:

- The `actor-start` event is charged once when a valid run starts.
- The `result` event is charged once for each product row saved.
- Invalid inputs fail before charging.
- Failed queries do not incur result charges.
- Account-tier discounts are applied automatically by Apify.

See the [live Apify Pricing tab](https://apify.com/fetch_cat/alibaba-products-suppliers-scraper/pricing) for current rates and account-tier discounts.

### FAQ

**What Alibaba product and supplier data can I export?**\
You can export Alibaba products and suppliers data including titles, product URLs, price and MOQ text, supplier names and storefronts, locations, verification signals, images, rank, and source query.

**Can I run the Alibaba products and suppliers scraper through an API or MCP client?**\
Yes. Use the Alibaba products and suppliers API examples above or connect the Actor through Apify's MCP server.

**How much does Alibaba product and supplier extraction cost?**\
The Actor charges once per valid run and once per saved result. See the live Pricing tab for current account-tier rates.

**Can it scrape product detail pages?**\
No. This actor focuses on search result rows and product URLs.

**Why can some fields be null?**\
Alibaba does not expose every supplier, MOQ, or price signal for every result.

### Related actors

- [Alibaba Product Search Scraper](https://apify.com/fetch_cat/alibaba-runtime-spike)
- [1688 Wholesale Products Scraper](https://apify.com/fetch_cat/1688-wholesale-products-scraper)
- [AliExpress Products Scraper](https://apify.com/fetch_cat/aliexpress-products-scraper)
- [Made-in-China Products Suppliers Scraper](https://apify.com/fetch_cat/made-in-china-products-suppliers-scraper)
- [Amazon Products Search Scraper](https://apify.com/fetch_cat/amazon-products-search-scraper)
- [Walmart Product Search Scraper](https://apify.com/fetch_cat/walmart-product-search-scraper)

### Support

When opening an issue, include your input JSON, expected output, actual output, and a reproducible public URL for the run, such as an Apify Console run URL or run ID.

# Actor input Schema

## `queries` (type: `array`):

Alibaba product search phrases, for example 'solar panel' or 'yoga mat'.

## `maxItemsPerQuery` (type: `integer`):

Maximum number of product result cards to save for each query.

## `navigationTimeoutMs` (type: `integer`):

Per-page navigation timeout. Keep this bounded to avoid expensive stalled runs.

## `maxRetriesPerQuery` (type: `integer`):

Retry count for transient navigation failures or blocked empty pages.

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

Residential proxies are recommended because Alibaba often blocks datacenter traffic.

## Actor input object example

```json
{
  "queries": [
    "solar panel"
  ],
  "maxItemsPerQuery": 10,
  "navigationTimeoutMs": 25000,
  "maxRetriesPerQuery": 1,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `products` (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 = {
    "queries": [
        "solar panel"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

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

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,fetch_cat/alibaba-products-suppliers-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/HLPV56b8bZHGLqFD6/builds/KxIkeHNU1W6xZnPON/openapi.json