# Alibaba Supplier/Company Scraper (`codenest/alibaba-supplier-company-scraper`) Actor

Input keyword, country name or supplier profile URLs to scrape detailed company data. Outputs complete business intelligence: verification status, manufacturing capabilities, R\&D capacity, trade markets, production metrics & more.

- **URL**: https://apify.com/codenest/alibaba-supplier-company-scraper.md
- **Developed by:** [CodeNest](https://apify.com/codenest) (community)
- **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 scraped supplier in-depth profiles

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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 Supplier/Company Scraper - Ultimate B2B Supplier Database Extractor

**Effortlessly scrape comprehensive supplier data from Alibaba with our powerful **Alibaba Supplier/Company Scraper**! This Apify actor enables bulk extraction of verified suppliers, complete company profiles, product catalogs, and trade intelligence.**

***

### 📋 Overview

Need to find reliable suppliers, analyze B2B markets, or build supplier databases? This **Alibaba Supplier/Company Scraper** delivers:

- 🏢 **Comprehensive Supplier Data** - Full company profiles, verification status, and contact details
- 📦 **Product Intelligence** - Featured products, categories, and specifications
- 🔍 **Advanced Search** - Multi-keyword support with automatic supplier discovery
- ✅ **Verification Detection** - Identify Gold Suppliers, Verified Suppliers, and Trade Assurance
- 📊 **Market Insights** - Revenue ranges, top markets, and supplier years of experience

Perfect for procurement professionals 🛒, supply chain analysts 📈, e-commerce entrepreneurs 🚀, and market researchers 🔬!

***

### ⭐ Core Capabilities of Alibaba Supplier/Company Scraper

#### 🏢 Supplier Extraction

- **Multi-Keyword Support** - Search across multiple product categories
- **Complete Supplier Profiles** - Names, IDs, years of experience, and verification levels
- **Trade Assurance Detection** - Identify suppliers with Trade Assurance protection
- **Direct URL Support** - Scrape specific supplier listing pages

#### 📦 Product Intelligence

- **Featured Products** - Product titles, IDs, and images
- **Product Categories** - Main product classifications
- **Product Counts** - Number of featured products per supplier
- **Video Detection** - Identify suppliers with video content

#### ✅ Verification & Quality

- **Verification Levels** - Gold Supplier, Verified Supplier, and more
- **Trade Assurance Limits** - Financial protection amounts
- **Supplier Years** - Experience and longevity metrics
- **Revenue Ranges** - Business size classification

#### 🌍 Market Intelligence

- **Top Markets** - Geographic distribution of sales
- **Country Detection** - Origin and flag visualization
- **Total Revenue** - Business revenue categorization
- **Tags & Categories** - Supplier specialization tags

***

### ⚙️ Input Configuration

Simply enter your keywords or listing URLs, configure limits, and click "Start". Input looks like this:

```json
{
  "country": "china",
  "keywords": [
    "dc motor",
    "car"
  ],
  "maxItems": 20,
  "urls": [],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

#### 📝 Input Specifications

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `keywords` | Array | ❌ No | \["shoes"] | Product keywords to search for suppliers |
| `country` | String | ❌ No | "CN" | Target country name or 2-letter ISO code (e.g. "China", "India", "Vietnam", "Turkey", "US") |
| `urls` | Array | ❌ No | \[] | Direct Alibaba supplier storefront or listing URLs |
| `maxItems` | Integer | ❌ No | 20 | Maximum suppliers to extract per keyword / URL |
| `maxTotalChargeUsd` | Number | ❌ No | None | Optional maximum spending limit in USD (e.g. 5.00) |
| `proxyConfiguration` | Object | ❌ No | Residential | Apify Proxy configuration (Residential recommended) |

***

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

This Actor operates under Apify's transparent **Pay-Per-Event (PPE)** pricing model. You only pay for verified supplier records successfully extracted and saved:

| Event Name | Pricing Type | Recommended Price | Description |
|------------|--------------|-------------------|-------------|
| `apify-actor-start` | Synthetic (Startup) | $0.00005 | Covers container startup and initial compute (Apify covers the first 5 seconds). |
| `scraped-supplier` | Custom (Primary Event) | $0.005 / supplier | Charged per verified Alibaba supplier profile extracted with complete company details, verification, ratings, images, and capabilities ($5.00 per 1,000 suppliers). |

- **🆓 Free Plan Policy:** Free tier users can test and scrape up to **3 supplier profiles per run** at no cost.
- **💎 Paid Plan:** Paying Apify subscribers enjoy **unlimited supplier scraping** with spending budget protection.
- 🛡️ **Zero Waste Guarantee:** You are never billed for failed queries, 404 pages, or empty listings. Charges only trigger when a complete supplier profile is written to your dataset.
- 🛑 **Spending Limit Protection:** Users can set a hard spending budget (`maxTotalChargeUsd`). The Actor automatically tracks usage via Apify's charging API and aborts gracefully before exceeding the limit.

***

### 📤 Output Structure

Your **Alibaba Supplier/Company Scraper** produces comprehensive supplier data with company profiles and product details:

```json
[
  {
    "supplierNo": 1,
    "supplierId": "291515036",
    "supplierName": "Hubei Yitong Automobile Import And Export Trading Co., Ltd.",
    "companyUrl": "https://ytqc.en.alibaba.com",
    "profileUrl": "https://ytqc.en.alibaba.com/company_profile.html",
    "contactUrl": "https://ytqc.en.alibaba.com/contactinfo.html",
    "supplierYears": "2 YRS",
    "verificationLevel": "Verified Supplier",
    "isVerified": true,
    "tradeAssurance": true,
    "tradeAssuranceLimit": "$5,200,000+",
    "storeRatings": "5.0/5.0 (3 Reviews)",
    "responseRate": "93.9%",
    "responseTime": "<=3h",
    "country": "China",
    "countryCode": "CN",
    "flagUrl": "https://is.alicdn.com/simg/single/nflag/cn.gif",
    "companyLogo": "https://sc02.alicdn.com/kf/H1cb51c964e384b9cb15e24066a55aa32i.jpg",
    "companyImages": [
      "https://sc02.alicdn.com/kf/H1cb51c964e384b9cb15e24066a55aa32i.jpg",
      "https://sc04.alicdn.com/kf/H1cb51c964e384b9cb15e24066a55aa32i.jpg",
      "https://s.alicdn.com/@sc02/kf/H27982310470f448ab5721532570696e4D.jpg"
    ],
    "mainProducts": "Used Car, New Car, New Energy Vehicle",
    "totalRevenue": "$5,200,000+",
    "topMarkets": "Middle East, South America, Southeast Asia",
    "tags": [
      "SGS Certified",
      "Custom Manufacturer"
    ],
    "featuredProducts": [
      {
        "productId": "1601569058372",
        "title": "2024 JAC A5 PLUS White 10t Chinese New Cheap Gasoline Car Manufacturer",
        "productUrl": "https://www.alibaba.com/product-detail/_1601569058372.html",
        "imgSrc": "https://s.alicdn.com/@sc04/kf/H9a421cb4ac964ddda73ce9fa70ddefc70.jpg_300x300.jpg",
        "price": "US $3280.00-$6899.00",
        "minOrder": "1 set"
      }
    ],
    "featuredProductsCount": 1,
    "searchKeyword": "car",
    "listingUrl": "https://www.alibaba.com/countrysearch/CN/manufacturer-car.html",
    "scrapedAt": "2026-10-27T14:52:00.000Z"
  }
]
```

#### 📖 Output Field Documentation

**🔹 Supplier Identification**
| Field | Description |
|-------|-------------|
| `supplierNo` | Sequential index number across the scrape run |
| `supplierId` | Alibaba unique supplier numeric ID |
| `supplierName` | Full registered company / factory name |
| `companyUrl` | Direct Alibaba storefront URL |
| `profileUrl` | Company profile & audit page URL |
| `contactUrl` | Contact information & inquiry page URL |

**🔹 Verification & Trust**
| Field | Description |
|-------|-------------|
| `supplierYears` | Verified years of operation on Alibaba (e.g. `2 YRS`, `15 YRS`) |
| `verificationLevel` | Verification status (`Verified Supplier`, `Gold Supplier`) |
| `isVerified` | Boolean verification status |
| `tradeAssurance` | Whether Trade Assurance buyer protection is active |
| `tradeAssuranceLimit` | Maximum Trade Assurance transaction coverage (e.g. `$5,200,000+`) |
| `storeRatings` | Customer review score & count (e.g. `5.0/5.0 (3 Reviews)`) |
| `responseRate` | Supplier inquiry response rate percentage (e.g. `98.7%`) |
| `responseTime` | Average response turnaround time (e.g. `<=3h`) |

**🔹 Business & Manufacturing Intelligence**
| Field | Description |
|-------|-------------|
| `country` | Country or territory of origin (e.g. `China`, `India`, `Vietnam`) |
| `countryCode` | ISO 2-letter country code (e.g. `CN`, `IN`, `VN`) |
| `flagUrl` | Country flag icon image URL |
| `companyLogo` | High-resolution company / factory logo URL |
| `companyImages` | Array of factory workshop, facility & storefront image URLs |
| `mainProducts` | Clean comma-separated list of primary manufactured products |
| `totalRevenue` | Annual revenue scale (e.g. `$5,000,000+`, `US $50M - $100M`) |
| `topMarkets` | Primary export market destinations |
| `tags` | Third-party inspection & capability tags (`SGS`, `TÜV`, `Intertek`, `OEM`) |

**🔹 Products & Context**
| Field | Description |
|-------|-------------|
| `featuredProducts` | Array of flagship products showcased by the supplier |
| `featuredProductsCount` | Number of featured products captured |
| `featuredProducts[].productId` | Alibaba product ID |
| `featuredProducts[].title` | Product title & model description |
| `featuredProducts[].productUrl` | Direct product detail page URL |
| `featuredProducts[].imgSrc` | High-resolution product thumbnail image URL |
| `featuredProducts[].price` | Wholesale pricing tier |
| `featuredProducts[].minOrder` | Minimum order quantity (MOQ) |
| `searchKeyword` | Product keyword used to discover this supplier |
| `listingUrl` | Source search listing or storefront page crawled |
| `scrapedAt` | ISO 8601 UTC timestamp of extraction |

***

### 🎨 Key Features of This Alibaba Supplier/Company Scraper

#### 🔍 Advanced Search Capabilities

- **Multi-Keyword Search** - Find suppliers across multiple product categories
- **Direct URL Scraping** - Extract from specific listing pages
- **Automatic Discovery** - Intelligent supplier identification
- **Country Filtering** - Origin-based supplier selection

#### ✅ Supplier Verification Intelligence

- **Gold Supplier Detection** - Premium membership identification
- **Verified Supplier Status** - Authenticity verification
- **Trade Assurance Limits** - Financial protection amounts
- **Years of Experience** - Supplier longevity metrics

#### 📊 Market Intelligence

- **Revenue Range Analysis** - Business size categorization
- **Top Markets Distribution** - Geographic sales insights
- **Product Specialization** - Main product categories
- **Tag-Based Filtering** - Supplier specialization tags

#### 📦 Product Intelligence

- **Featured Product Extraction** - Product titles and IDs
- **Image Collection** - Product thumbnail URLs
- **Product Count Analysis** - Number of featured products
- **Video Detection** - Content media presence

***

### 💡 Use Cases for Alibaba Supplier/Company Scraper

- **🛒 Procurement Teams** - Find reliable suppliers for manufacturing
- **📊 Market Analysts** - Track B2B supplier trends and pricing
- **🚀 E-commerce Entrepreneurs** - Discover products and suppliers
- **🔬 Supply Chain Researchers** - Study global trade patterns
- **📈 Business Developers** - Identify potential partnership opportunities
- **🏭 Manufacturers** - Find subcontractors and material suppliers
- **🎯 Marketing Teams** - Analyze supplier landscapes
- **💼 Investors** - Assess B2B market opportunities

***

### ✨ Why Choose Our Alibaba Supplier/Company Scraper?

- **⚡ Blazing Fast** - Concurrent scraping with intelligent proxy rotation
- **🎯 100% Accurate** - Preserves all supplier data without alteration
- **🔄 Regular Updates** - Adapts to Alibaba platform changes automatically
- **📦 Complete Data** - Everything from verification to product details
- **🛡️ Production Ready** - Battle-tested with thousands of suppliers
- **💰 Cost Efficient** - Optimized to minimize compute time
- **🔒 Privacy Focused** - No personal data stored or shared

***

### ⚠️ Limitations

- Only works with publicly accessible Alibaba supplier pages
- Some supplier data may require login or specific access
- Extremely high concurrency may trigger rate limiting
- Search results limited to Alibaba's available inventory
- Featured products may vary by supplier listing page

***

### 🔗🛠 Complete B2B Sourcing Scraper Suite

Explore our professional data extraction collection:

#### 🏭 Supplier Scrapers:

- [Alibaba Supplier/Company Scraper](https://apify.com/codenest/alibaba-supplier-company-scraper) - YOU ARE HERE
- [Made In China Supplier/Company Scraper](https://apify.com/codenest/made-in-china-supplier-company-scraper)
- [Zillow Agent Profile Scraper](https://apify.com/codenest/zillow-agent-profile-scraper)

#### 📊 Product Scrapers:

- [Made in China Product Scraper](https://apify.com/codenest/made-in-china-product-scraper)
- [Made In China Top Ranking Product Scraper](https://apify.com/codenest/made-in-china-top-ranking-product-scraper)
- [Zillow Property Scraper](https://apify.com/codenest/zillow-property-scraper)
- [Alibaba Product Scraper](https://apify.com/codenest/alibaba-product-scraper)
- [Amazon Product Scraper](https://apify.com/codenest/amazon-product-scraper)
- [Amazon Deals Scraper](https://apify.com/codenest/amazon-deals-scraper)
- [Zillow Property & Apartment Scraper](https://apify.com/codenest/zillow-property-apartment-scraper)
- [Made In China Product & Company Details Scraper](https://apify.com/codenest/made-in-china-product-company-details-scraper)

***

### 📧 Need Custom Features for Your Alibaba Supplier/Company Scraper?

Want **additional supplier fields**, **specific verification criteria**, **custom output formats**, **advanced analytics**, or **automated reporting**?

✉️ Email **<codenest2.0@gmail.com>** for tailored enterprise solutions!

***

# Actor input Schema

## `keywords` (type: `array`):

Enter one or more search keywords (each line is one independent supplier search).

The scraper automatically constructs the exact Alibaba Countrysearch Manufacturer URL:
'textiles' + 'India' ➡️ 'https://www.alibaba.com/countrysearch/IN/manufacturer-textiles.html'
'shoes' + 'Vietnam' ➡️ 'https://www.alibaba.com/countrysearch/VN/manufacturer-shoes.html'

And crawls the supplier listings across multiple pages to scrape full company details, verification levels, trade assurance, main products, revenue, markets, company images, and featured products.

Example:
• textiles
• shoes
• electric car

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

Enter the supplier country name or 2-letter ISO country code:
• India or IN
• Vietnam or VN
• Pakistan or PK
• Turkey or TR
• Bangladesh or BD
• United States or US
• China or CN (Default)
• Germany or DE, Italy or IT, Japan or JP, etc.

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

Optionally enter direct Alibaba.com supplier storefront or listing URLs to scrape (each line is one URL).

Supported URL types:
• Direct Supplier Storefront / Profile URLs (e.g. 'https://ytqc.en.alibaba.com/', 'https://ytqc.en.alibaba.com/company_profile.html')
• Manufacturer listing pages (e.g. 'https://www.alibaba.com/countrysearch/IN/manufacturer-textiles.html')
• Paginated supplier pages (e.g. 'https://www.alibaba.com/countrysearch/IN/manufacturer-textiles_2.html')
• Supplier listing pages (e.g. 'https://www.alibaba.com/shoes-suppliers.html')

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

Maximum number of suppliers to scrape per keyword search or listing URL. Default is 20.

## `maxTotalChargeUsd` (type: `number`):

Optional maximum spending limit in USD for Pay-Per-Event pricing (e.g. 5.00 for $5.00 USD). If reached, the scraper will gracefully stop and save all results scraped so far.

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

Select Apify Proxy (Residential recommended) or provide custom proxy URLs for reliable scraping.

## Actor input object example

```json
{
  "keywords": [
    "shoes"
  ],
  "country": "CN",
  "urls": [],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `suppliers` (type: `string`):

Dataset containing all scraped Alibaba suppliers with company profiles, verification levels, trade assurance, main products, revenue, export markets, and featured products.

## `outputRecord` (type: `string`):

Complete structured JSON dataset output stored in default Key-Value Store

# 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("codenest/alibaba-supplier-company-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("codenest/alibaba-supplier-company-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 codenest/alibaba-supplier-company-scraper --silent --output-dataset

```

## MCP server setup

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