# Alibaba Supplier Scraper (`codingfrontend/alibaba-supplier-scraper`) Actor

Extract detailed Supplier profiles from Alibaba.com for vendor sourcing and supply chain research. Get Gold Supplier tenure,factory size, staff count, annual revenue, response rates, product portfolios, ratings and verification status.

- **URL**: https://apify.com/codingfrontend/alibaba-supplier-scraper.md
- **Developed by:** [Coding Frontned](https://apify.com/codingfrontend) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

### What this Actor does

This Actor finds supplier listings on [Alibaba.com](https://www.alibaba.com/) from keywords or public supplier-list URLs, then saves validated supplier records to an Apify dataset. It can optionally visit accessible public supplier profiles for additional company facts.

The Actor uses public pages only. It does not log in, collect private contact details, or bypass access controls, and it follows Alibaba's public `robots.txt` rules. Public pages and the fields they show can change over time.

### Why use this Actor?

Use it to build supplier shortlists, compare the business facts Alibaba publishes, or revisit the same searches over time. Apify can schedule recurring runs, call the Actor through its API, connect results to other tools, and show run history so you can track collection outcomes.

### How to run the Alibaba supplier search

1. Open the Actor's **Input** tab.
2. Enter supplier keywords in `queries`, add native supplier-list URLs in `urls`, or use both.
3. Choose the page and result limits. Turn on `includeDetails` only when you want public profile facts.
4. Start the run. Open the **Dataset** to review saved supplier records.
5. Open **Key-value store → `OUTPUT_SUMMARY`** for the run status and saved-record count.

All input fields are optional. When both `queries` and `urls` are empty or omitted, the Actor searches Alibaba's public Company Search supplier page. If both contain entries, it combines direct URLs first and keyword sources second, then removes duplicates. Each list accepts up to 20 entries, and the combined source list can contain at most 20 unique entries. Invalid supplied values stop input validation; they do not fall back to the default search.

### Input fields

| Field | Type | Required? | Default | Bounds and behavior |
| --- | --- | --- | --- | --- |
| `queries` | Array of strings | No | `[]` | Up to 20 nonblank keywords, each up to 200 Unicode characters. Each keyword creates a public supplier-list source. |
| `urls` | Array of objects | No | `[]` | Up to 20 native public Alibaba supplier-list URLs. Use absolute HTTPS URLs without credentials, explicit ports, fragments, or legacy keyword/page query rewrites. |
| `urls[].url` | String | Yes, for each URL object | None | Required property of each `urls` item; up to 2,000 characters. The item supports only this property. |
| `max_pages` | Integer | No | `1` | `1`–`20` pages per keyword or direct URL source. The run processes at most 20 search pages total. |
| `maxResults` | Integer | No | `20` | `1`–`1,000` unique supplier records across the run. |
| `includeDetails` | Boolean | No | `false` | When `true`, request accessible public supplier profiles for additional visible facts. |
| `timeoutMs` | Integer | No | `30000` | Request timeout in milliseconds, from `5000` to `120000`. |
| `maxResponseBytes` | Integer | No | `5000000` | Maximum accepted response size, from `1000` to `15000000` bytes. |

Each URL must match an approved public Alibaba supplier-list route. The Actor rejects malformed URLs, unsupported routes, blank list entries, unknown input fields, `null` values, and values of the wrong type before it starts requests. For `queries` and `urls`, an omitted field and an empty array have the same behavior.

#### Input examples

Use Alibaba's default public Company Search supplier page:

```json
{
  "queries": [],
  "urls": []
}
```

Search for suppliers by two keywords and collect up to two pages per keyword:

```json
{
  "queries": [
    "industrial valves",
    "safety gloves"
  ],
  "max_pages": 2,
  "maxResults": 50,
  "includeDetails": true
}
```

Start from two native public supplier-list URLs:

```json
{
  "urls": [
    {
      "url": "https://www.alibaba.com/business-suppliers.html"
    },
    {
      "url": "https://www.alibaba.com/company-search-suppliers_2.html"
    }
  ],
  "max_pages": 2,
  "maxResults": 40
}
```

Combine a keyword with a direct supplier-list URL:

```json
{
  "queries": [
    "industrial valves"
  ],
  "urls": [
    {
      "url": "https://www.alibaba.com/business-suppliers.html"
    }
  ],
  "max_pages": 2,
  "maxResults": 80,
  "includeDetails": true
}
```

### Dataset output

Each dataset item is one supplier record. Only facts supported by the public source are included; unavailable properties are omitted. Supplier identity must include a supplier name and either a positive numeric Alibaba supplier ID or a validated public Alibaba profile URL. The example below shows the full nested record shape. **All example values are illustrative and do not claim to be a current Alibaba result.**

```json
{
  "supplierId": "202750899",
  "supplierName": "Example Industrial Components Co., Ltd.",
  "profileUrl": "https://www.alibaba.com/company/example-industrial-components.html",
  "country": "China",
  "businessType": "Manufacturer",
  "companyLocation": "Guangdong, China",
  "yearEstablished": 2016,
  "introduction": "Illustrative public company introduction.",
  "logoUrl": "https://sc01.alicdn.com/kf/example-company-logo.jpg",
  "trademarks": [
    "ExampleMark"
  ],
  "productionLines": 6,
  "contractManufacturing": "Available",
  "annualOutputValue": "US$10 million",
  "annualProductionCapacity": [
    {
      "productName": "Industrial valves",
      "unitsProduced": 100000,
      "unitType": "Pieces"
    }
  ],
  "factoryLocation": "Guangdong, China",
  "companyImages": [
    {
      "url": "https://sc01.alicdn.com/kf/example-company-overview.jpg",
      "alt": "Example company overview"
    }
  ],
  "verificationStatus": "Verified Supplier",
  "badges": [
    "Verified Supplier"
  ],
  "yearsOnAlibaba": 8,
  "factorySize": "5,000–10,000 square meters",
  "employees": "51–100",
  "annualRevenue": "US$1 million–US$2.5 million per year",
  "totalRevenue": "US$1 million–US$2.5 million",
  "responseRate": 69.8,
  "rating": 4.8,
  "reviewCount": 2,
  "certifications": [
    "ISO 9001",
    "CE"
  ],
  "mainProducts": "Industrial valves and pipe fittings",
  "topMarkets": "North America 60%, Western Europe 25%",
  "productUrls": [
    "https://www.alibaba.com/product-detail/example-industrial-valve_1000000000000.html"
  ],
  "countryCode": "CN",
  "products": [
    {
      "productId": "1000000000000",
      "name": "Example industrial valve",
      "url": "https://www.alibaba.com/product-detail/example-industrial-valve_1000000000000.html",
      "image": {
        "url": "https://sc01.alicdn.com/kf/example-industrial-valve.jpg_200x200.jpg",
        "thumbnailUrl": "https://sc01.alicdn.com/kf/example-industrial-valve.jpg_100x100.jpg",
        "alt": "Example industrial valve"
      }
    }
  ],
  "markets": [
    {
      "name": "North America",
      "sharePercent": 60
    },
    {
      "name": "Western Europe",
      "sharePercent": 25
    }
  ],
  "supplierTags": [
    {
      "name": "Industrial Valve Supplier",
      "url": "https://www.alibaba.com/industrial-valve-suppliers.html"
    }
  ],
  "tradeAssurance": {
    "limitText": "US $25,000",
    "currency": "USD",
    "limit": 25000
  },
  "performance": {
    "onlineRevenue": "US$10,000–US$20,000",
    "topBuyersServed": 12,
    "shippingDays": "15 days",
    "responseTime": "5 hours",
    "reorderRate": "25%",
    "yearsOnAlibaba": "10 years",
    "industryAverages": {
      "shippingDays": "20 days",
      "responseTime": "10 hours",
      "reorderRate": "18%",
      "yearsOnAlibaba": "8 years"
    }
  }
}
```

#### Supplier fields

| Field | Type | Required? | Meaning |
| --- | --- | --- | --- |
| `supplierId` | String | Optional identity value | Positive decimal supplier ID with 8–30 digits, observed on the public listing. At least one of `supplierId` or `profileUrl` must be present. |
| `supplierName` | String | Yes | Supplier name shown on the public listing. |
| `profileUrl` | URL string | Optional identity value | Validated public Alibaba supplier profile URL. At least one of `supplierId` or `profileUrl` must be present. |
| `country` | String | Optional | Country or region shown in the source. |
| `businessType` | String | Optional | Published business type. |
| `companyLocation` | String | Optional | Published company location. |
| `yearEstablished` | Nonnegative integer | Optional | Published year the company was established. |
| `introduction` | String | Optional | Public company introduction. |
| `logoUrl` | URL string | Optional | Validated public company logo image URL. |
| `trademarks` | Array of strings | Optional | Published trademarks. |
| `productionLines` | Nonnegative integer | Optional | Published number of production lines. |
| `contractManufacturing` | String | Optional | Published contract-manufacturing value. |
| `annualOutputValue` | String | Optional | Published annual output value, preserved as text. |
| `annualProductionCapacity` | Array of objects | Optional | Published production capacity by product. |
| `factoryLocation` | String | Optional | Published factory location. |
| `companyImages` | Array of objects | Optional | Published company-overview images. |
| `verificationStatus` | String | Optional | Public supplier verification label. |
| `badges` | Array of strings | Optional | Public supplier badges. |
| `yearsOnAlibaba` | Number | Optional | Published Alibaba tenure in years. |
| `factorySize` | String | Optional | Published factory-size fact. |
| `employees` | String | Optional | Published employee-count fact or range. |
| `annualRevenue` | String | Optional | Revenue only when the source explicitly labels it as annual. |
| `totalRevenue` | String | Optional | Revenue shown under a `Total Revenue` label when the reporting period is not specified. |
| `responseRate` | Number | Optional | Published response-rate percentage. |
| `rating` | Number | Optional | Published supplier rating. |
| `reviewCount` | Nonnegative integer | Optional | Published supplier review count. |
| `certifications` | Array of strings | Optional | Public certifications shown in supplier facts. |
| `mainProducts` | String | Optional | Text from an explicit `Main Products` source field; product-preview titles are not used for this field. |
| `topMarkets` | String | Optional | Published top-market text. |
| `productUrls` | Array of URL strings | Optional | Deduplicated public product links associated with the supplier. |
| `countryCode` | String | Optional | Two-letter country or region code observed in the source. |
| `products` | Array of objects | Optional | Up to 100 product previews owned by this supplier's listing card. |
| `markets` | Array of objects | Optional | Up to 100 published market labels and percentages. |
| `supplierTags` | Array of objects | Optional | Up to 100 public supplier-category tags and their links. |
| `tradeAssurance` | Object | Optional | Published Trade Assurance limit details. |
| `performance` | Object | Optional | Published supplier performance metrics and, when available, separate industry averages. |

#### Nested fields

Required fields apply when the containing object or array item is present. The published list arrays contain no more than 100 items. The `performance` and `industryAverages` objects contain only source-backed optional values.

| Field | Type | Required? | Meaning |
| --- | --- | --- | --- |
| `annualProductionCapacity[].productName` | String | Yes | Published product name for the capacity row. |
| `annualProductionCapacity[].unitsProduced` | Nonnegative integer | Optional | Published number of units produced. |
| `annualProductionCapacity[].unitType` | String | Optional | Source unit label, preserved literally (for example, `Piece/Pieces`). |
| `companyImages[].url` | URL string | Yes | Validated public company image URL. |
| `companyImages[].alt` | String | Optional | Published company image alternative text. |
| `products[].productId` | String | Yes | Native decimal product ID that matches the ID in its URL. |
| `products[].url` | URL string | Yes | Validated public Alibaba product URL. |
| `products[].name` | String | Yes | Published product title associated with this supplier's card. |
| `products[].image` | Object | Optional | Published image details associated with this product. |
| `products[].image.url` | URL string | Yes, if `image` is present | Validated published image URL. |
| `products[].image.thumbnailUrl` | URL string | Optional | Separate smaller published image URL. |
| `products[].image.alt` | String | Optional | Published image alternative text. |
| `markets[].name` | String | Yes | Published market label. |
| `markets[].sharePercent` | Number | Optional | Published share from `0` to `100`. |
| `supplierTags[].name` | String | Yes | Published supplier tag. |
| `supplierTags[].url` | URL string | Yes | Validated public supplier-list URL linked from the tag. |
| `tradeAssurance.limitText` | String | Yes | Source-labeled limit text. |
| `tradeAssurance.currency` | String | Optional | `USD` only when the source explicitly identifies US dollars. |
| `tradeAssurance.limit` | Number | Optional | Parsed nonnegative amount when the source explicitly shows a US-dollar value. |
| `performance.onlineRevenue` | String | Optional | Published online revenue text. |
| `performance.topBuyersServed` | Nonnegative integer | Optional | Published number of top buyers served. |
| `performance.shippingDays` | String | Optional | Supplier's published average dispatch time, preserved with its source unit. |
| `performance.responseTime` | String | Optional | Supplier's published response-time metric. |
| `performance.reorderRate` | String | Optional | Supplier's published reorder-rate metric. |
| `performance.yearsOnAlibaba` | String | Optional | Source-preserved tenure metric within the performance panel. |
| `performance.industryAverages` | Object | Optional | Included only when industry-average source values are available. |
| `performance.industryAverages.shippingDays` | String | Optional | Published industry-average dispatch time, kept separate from the supplier's value. |
| `performance.industryAverages.responseTime` | String | Optional | Published industry-average response-time metric, kept separate from the supplier's value. |
| `performance.industryAverages.reorderRate` | String | Optional | Published industry-average reorder-rate metric, kept separate from the supplier's value. |
| `performance.industryAverages.yearsOnAlibaba` | String | Optional | Published industry-average tenure metric, kept separate from the supplier's value. |

Product preview fields are linked to the card where they appeared. IDs must match their published URLs; unrelated neighboring-card products are not attached to the supplier. `annualRevenue` and `totalRevenue` preserve the source's labels rather than inferring a reporting period. Market shares are retained with their named markets and need not total 100%.

Product previews are the products shown on each supplier's listing card, so they may cover only part of that supplier's catalog. If Alibaba refuses a public profile request, the Actor retains the listing facts and marks the successful run as partial. Profile-only fields are omitted when they cannot be collected.

You can download the dataset in formats such as JSON, HTML, CSV, or Excel from the Apify dataset viewer.

### How much does it cost?

Check the Actor's **Pricing** tab for current pricing before you run it. Run duration and the amount of public profile information requested can affect resource use; this README does not state a price.

### Run status and output summary

The Actor writes `OUTPUT_SUMMARY` to the run's default **Key-value store**, separately from the supplier dataset. The summary always has exactly these three fields:

| Field | Type | Required? | Default or meaning |
| --- | --- | --- | --- |
| `status` | String | Yes | `SUCCEEDED` when at least one validated record was saved; otherwise `FAILED`. |
| `itemsStored` | Nonnegative integer | Yes | Number of validated supplier records whose dataset writes completed. |
| `isPartial` | Boolean | Yes | `true` when records were saved but a collection, profile, or storage error limited the run; otherwise `false`. |

Successful run:

```json
{
  "status": "SUCCEEDED",
  "itemsStored": 12,
  "isPartial": false
}
```

Run with saved records and a partial failure:

```json
{
  "status": "SUCCEEDED",
  "itemsStored": 5,
  "isPartial": true
}
```

Run with no saved supplier records:

```json
{
  "status": "FAILED",
  "itemsStored": 0,
  "isPartial": false
}
```

### Tips and support

- Start with a specific keyword and a small `maxResults` value; increase limits when you need more suppliers.
- Enable `includeDetails` when public profile facts matter. Profile requests can increase run time, and some profiles may not be accessible.
- Alibaba can change or restrict public pages. A run may therefore save fewer records than its result limit.

### Legal and support

Use this Actor for public supplier and business information in line with Alibaba's terms, its public `robots.txt` policy, and applicable privacy laws. You are responsible for having a lawful reason to collect and use the results. Do not use the Actor to gather private contact details, bypass access controls, or collect personal data without a lawful basis. For help, use the support option on the [Actor's Apify page](https://apify.com/codingfrontend/alibaba-supplier-scraper) and include the run link.

# Actor input Schema

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

Optional supplier-search keywords. Each nonblank query is converted to a public Alibaba supplier-list URL. Up to 20 queries, each no longer than 200 Unicode characters.

## `urls` (type: `array`):

Optional direct URLs to native public Alibaba supplier-list pages. Use absolute HTTPS URLs without credentials, ports, fragments, or legacy keyword/page query rewrites. Up to 20 URLs, each no longer than 2,000 characters.

## `max_pages` (type: `integer`):

Maximum public supplier-list pages to follow for each URL or keyword source.

## `maxResults` (type: `integer`):

Maximum number of unique validated supplier records to save across all sources.

## `includeDetails` (type: `boolean`):

Open an accessible public supplier profile to collect additional visible company facts.

## `timeoutMs` (type: `integer`):

Timeout for each public supplier or robots request.

## `maxResponseBytes` (type: `integer`):

Largest public search or profile response accepted.

## Actor input object example

```json
{
  "queries": [],
  "urls": [],
  "max_pages": 1,
  "maxResults": 20,
  "includeDetails": false,
  "timeoutMs": 30000,
  "maxResponseBytes": 5000000
}
```

# Actor output Schema

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

No description

## `runSummary` (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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("codingfrontend/alibaba-supplier-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("codingfrontend/alibaba-supplier-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 '{}' |
apify call codingfrontend/alibaba-supplier-scraper --silent --output-dataset

```

## MCP server setup

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