# Alibaba Reviews & Ratings Scraper (`xtracto/alibaba-review-scraper`) Actor

Pull aggregate review/rating data plus per-criterion supplier scoring (services / shipping / quality) and SLA proxies from Alibaba product or supplier URLs.

- **URL**: https://apify.com/xtracto/alibaba-review-scraper.md
- **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community)
- **Categories:** E-commerce, Lead generation, Other
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 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.
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 Review Scraper

Extract aggregate buyer ratings, per-criterion supplier scores (services / shipping / product quality), and operational metrics (response time, on-time delivery rate, Trade Assurance) from any Alibaba product or supplier URL.

### Why use this actor

- No Alibaba account or login required — all rating and SLA data is publicly visible.
- Per-criterion breakdown (services, shipping, product quality) surfaces fast-ship or low-quality suppliers that overall star averages alone would miss.
- Accepts both product detail URLs and supplier storefront URLs — supplier URLs are resolved to a representative product automatically.
- Every record is a flat, structured object ready to score, rank, or feed into a pipeline or LLM.
- Operational SLA metrics (response time, on-time delivery rate) are included alongside ratings in each record.
- Export to JSON, CSV, or Excel directly from the Apify Console.

### How it works

1. You provide a list of Alibaba product URLs, supplier storefront URLs, or a mix of both.
2. For supplier storefront URLs, the actor automatically locates a representative product to retrieve rating data — no extra configuration needed.
3. The product page is parsed to extract the aggregate rating, total review count, and the full per-criterion breakdown with star-distribution percentages.
4. Supplier SLA metrics (response time, on-time delivery rate, Trade Assurance amount) and trust flags (Gold Supplier tier, paid member status) are merged into the same record.
5. One record per product is saved to your dataset. Download as JSON, CSV, or Excel when the run completes.

You don't need to manage any browsers or scrapers.

### Input

```json
{
    "urls": [
        { "url": "https://www.alibaba.com/product-detail/WATA-In-Ear-Waterproof-Sport-Earbud_1601685362945.html" }
    ],
    "maxConcurrency": 2,
    "maxRequestRetries": 8,
    "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}
```

| Field | Type | Description |
| --- | --- | --- |
| `urls` | URL\[] | Alibaba product detail URLs or supplier storefront URLs. Supplier URLs are resolved automatically. |
| `maxConcurrency` | integer | Number of URLs processed in parallel. Default: 2. |
| `maxRequestRetries` | integer | How many times a failed request is retried before skipping. Default: 8. |
| `proxyConfiguration` | object | Apify Proxy settings or a custom proxy list. RESIDENTIAL group recommended. |

### Output

```json
{
    "recordType": "AGGREGATE",
    "productId": 1601685362945,
    "productTitle": "WATA CEB206 ANC TWS In-Ear Waterproof Sport Earbud",
    "companyId": 250873711,
    "companyName": "WATA Electronics Co., Ltd",
    "companyRegisterCountry": "CN",
    "companyJoinYears": "6",
    "productAverageStar": 0.0,
    "productTotalReviewCount": 252,
    "supplierAverageStar": 0.0,
    "responseTimeText": "within 24 hours",
    "onTimeDeliveryRate": "91.0%",
    "isGoldPlusSupplier": false,
    "scrapedAt": "2026-05-30T04:37:55Z"
}
```

| Field | Type | Description |
| --- | --- | --- |
| `recordType` | string | Always `"AGGREGATE"` — one record per product containing all available rating signals. |
| `productId` | integer | Alibaba's unique product identifier. |
| `productTitle` | string | Full title of the product listing. |
| `companyId` | integer | Alibaba's internal supplier company ID. |
| `companyName` | string | Registered name of the supplier. |
| `companyRegisterCountry` | string | ISO country code of the supplier's registered country. |
| `companyJoinYears` | string | Number of years the supplier has been a paid Alibaba member. |
| `productAverageStar` | number | Aggregate star rating for this product (0.0 when no ratings yet). |
| `productTotalReviewCount` | integer | Total number of buyer reviews recorded for this product. |
| `supplierAverageStar` | number | Overall star rating for the supplier across all their products. |
| `responseTimeText` | string | Supplier's typical inquiry response time (e.g. `"within 24 hours"`). |
| `onTimeDeliveryRate` | string | Percentage of the supplier's orders delivered on time. |
| `isGoldPlusSupplier` | boolean | Whether the supplier currently holds Gold Plus status on Alibaba. |
| `scrapedAt` | string | ISO 8601 timestamp of when the record was collected. |

Note: Per-buyer review text is gated behind a signed API that Alibaba does not expose to public traffic. The actor returns rich aggregate data covering all key supplier scoring signals. Use the `feedbackUrl` field (included when available) to read individual buyer comments in a browser.

### Other Alibaba Scrapers

| Actor | Description |
| --- | --- |
| [Alibaba Search Scraper](https://apify.com/misceres/alibaba-search-scraper) | Search results with supplier, pricing, and MOQ for any keyword. |
| [Alibaba Product Scraper](https://apify.com/misceres/alibaba-product-scraper) | Full product detail: ladder pricing, SKU matrix, inventory, and supplier profile. |
| [Alibaba Company Scraper](https://apify.com/misceres/alibaba-company-scraper) | Complete supplier profile from any Alibaba storefront subdomain. |
| [Alibaba RFQ Scraper](https://apify.com/misceres/alibaba-rfq-scraper) | Live buying requests from Alibaba's sourcing marketplace. |
| [Alibaba Review Scraper](https://apify.com/misceres/alibaba-review-scraper) | Aggregate ratings, per-criterion scores, and supplier SLA metrics. |

# Actor input Schema

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

Mix of Alibaba product URLs and supplier subdomain URLs. Supplier URLs auto-resolve via productlist.html to a representative product. Output is one AGGREGATE row per product (averageStar, totalReviewCount, supplierRatingByCriterion, feedbackUrl). Alibaba's per-buyer review-text API is signed by an MTOP endpoint Alibaba no longer exposes to public traffic — only aggregate signals are reachable HTTP-only.

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

Parallel workers per actor run.

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

Per-request retry budget for HTML detail fetches.

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

Apify Proxy or your own list. RESIDENTIAL recommended for detail HTML.

## Actor input object example

```json
{
  "urls": [
    {
      "url": "https://www.alibaba.com/product-detail/WATA-In-Ear-Waterproof-Sport-Earbud_1601685362945.html"
    }
  ],
  "maxConcurrency": 2,
  "maxRequestRetries": 8,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {
    "urls": [
        {
            "url": "https://www.alibaba.com/product-detail/WATA-In-Ear-Waterproof-Sport-Earbud_1601685362945.html"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("xtracto/alibaba-review-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 = {
    "urls": [{ "url": "https://www.alibaba.com/product-detail/WATA-In-Ear-Waterproof-Sport-Earbud_1601685362945.html" }],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("xtracto/alibaba-review-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    {
      "url": "https://www.alibaba.com/product-detail/WATA-In-Ear-Waterproof-Sport-Earbud_1601685362945.html"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call xtracto/alibaba-review-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=xtracto/alibaba-review-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/DLyfCiK7f0X1POM3P/builds/LF6alFmwUI0ZxppeH/openapi.json