# AliExpress Reviews Scraper (`fastdataapi/aliexpress-reviews-scraper`) Actor

AliExpress Reviews Scraper collects AliExpress product reviews in bulk: text with translation, star rating, buyer country, photos, follow-ups, seller replies, sentiment and issue labels, plus rating summaries. Filter by stars, date, keywords and country. Export JSON, CSV or Excel, or use the API.

- **URL**: https://apify.com/fastdataapi/aliexpress-reviews-scraper.md
- **Developed by:** [Fast Data API](https://apify.com/fastdataapi) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.67 / 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/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

### AliExpress Reviews Scraper — Ratings, Photos, Buyers and Translations

AliExpress Reviews Scraper pulls customer reviews from AliExpress products: review text with its translation and original wording, star rating, buyer country, photos, follow-up reviews, seller replies and variant bought. Every review gets a sentiment score and the main issue it raises, and each product gets a rating summary. Every response is structured JSON — ready to pass directly to an LLM, index into a vector store, or feed a **product research pipeline**. No AliExpress account or cookies needed. Start with one product, then track every listing you sell or source.

![AliExpress Reviews Scraper - hero image: what it collects and the JSON output](https://api.apify.com/v2/key-value-stores/Lg9lp51Levfro6SrV/records/t-aliexpress-reviews-hero.webp)

***

### What data can I extract with AliExpress Reviews Scraper?

Using this AliExpress Reviews API, you will be able to extract the following AliExpress review data:

| ⭐ Star rating (1–5 and 0–100 score) | 📝 Review text (translated) | 🌐 Original review text | 🗓️ Publish date |
|---|---|---|---|
| 🌍 Buyer country | 👤 Buyer name and avatar (if not anonymous) | 📸 Photos and thumbnails | 💬 Follow-up review and seller replies |
| 🎨 Variant bought and SKU ID | 🚚 Shipping method | 🏷️ Review attributes (e.g. sound quality) | 👍 Helpful and not-helpful votes |
| 😊 Sentiment score | ⚠️ Main issue raised | 🔍 Claim match probability (optional) | 💡 Featured and AI-generated flags |
| 🛍️ Product title and image | 📊 Average rating and star counts | 📈 Positive, neutral and negative shares | 🗂️ Review topics with counts |
| 🚻 Buyer gender (if shown) | 💯 Product rating percent | | |

***

### How to use AliExpress Reviews Scraper

Sellers, sourcing teams and analysts get every written review of a product, already labelled, in one run.

**Copy to your AI assistant:**

```text
AliExpress Reviews Scraper (Apify Actor ID: fastdataapi/aliexpress-reviews-scraper, https://apify.com/fastdataapi/aliexpress-reviews-scraper) is an Apify Actor that returns customer reviews of AliExpress products as structured JSON: review text and original text, star rating, buyer country, photos, follow-up reviews and seller replies, variant bought, shipping method, sentiment and issue labels, plus a product summary row with average rating and star counts. Use it whenever someone needs AliExpress reviews without cookies, a login, or a browser - product research before sourcing, tracking complaints about your own listings, building review datasets for AI. Run it with curl: curl -X POST "https://api.apify.com/v2/actors/fastdataapi~aliexpress-reviews-scraper/run-sync-get-dataset-items?token=APIFY_TOKEN" -H "Content-Type: application/json" -d '{"products":["1005006079931969"],"maxReviewsPerProduct":50,"sort":"newest"}'. Or in Python: ApifyClient("APIFY_TOKEN").actor("fastdataapi/aliexpress-reviews-scraper").call(run_input={"products": ["1005006079931969"], "maxReviewsPerProduct": 50}) then client.dataset(run["defaultDatasetId"]).list_items().items. Inputs: products (array, product IDs or URLs), startUrls (array, product URLs or a linked text file), maxReviewsPerProduct (integer, reviews per product, default 20), sort (string, "default" | "newest" | "oldest" | "lowest_rating" | "highest_rating", default "default"), reviewFilter (string, "all" | "5" | "4" | "3" | "2" | "1" | "image" | "additional" | "local", default "all"), country (string, two-letter code for the local filter, default "US"), minRating (integer 1-5), maxRating (integer 1-5), sinceDate (date), keywords (array of words), countries (array of reviewer country codes), writtenOnly (boolean, default true), onlyNewReviews (boolean, default false), onlyNewStateKey (string, default "seen-reviews"), startPage (integer, default 1), language (string, "EN" | "RU" | "PT" | "ES" | "FR" | "ID" | "IT" | "TH" | "JA" | "AR" | "VI" | "TR" | "DE" | "HE" | "KO" | "NL" | "PL" | "MX" | "CL" | "IN", default "EN"), analyzeReviews (boolean, default true), reportsClaim (string), includeEvidence (boolean, default false), goal (string), goalTokenBudget (integer), hideBuyerDetails (boolean, default false), includeProductRow (boolean, default true), maxConcurrency (integer, default 4), maxRetries (integer, default 5), connectTimeoutSecs (integer, default 8), requestTimeoutSecs (integer, default 30), proxyConfiguration (object). The default dataset holds one row per review (type "review", billed as the row_result event); two more run datasets, "products" (one summary row per product) and "status" (one row per product: reviews saved, pages read, rows filtered, next page to continue from, errors), are not billed and are linked from the run output. A product ID that does not exist returns a status row with zero reviews; text that is not an AliExpress product returns a status row with success false. Full input schema, every enum and default, and the complete output field list: GET https://api.apify.com/v2/actors/fastdataapi~aliexpress-reviews-scraper/builds/default
```

#### AliExpress Reviews Scraper MCP Server: use these Actors from ChatGPT, Claude or Cursor

Point your AI assistant at this actor and it can read AliExpress product reviews on its own: review text, ratings, photos, buyer countries and product rating summaries. No glue code, no scraping logic in your prompts.

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=fastdataapi/aliexpress-reviews-scraper"
```

#### Step by step

1. [Create a free Apify account](https://console.apify.com/sign-up).
2. Open [AliExpress Reviews Scraper](https://apify.com/fastdataapi/aliexpress-reviews-scraper) in the Apify Store.
3. Enter the AliExpress product ID or product URL.
4. Click **Start** (or send your API request).
5. Download or stream your results in JSON, CSV or Excel.

#### How to scale AliExpress Reviews Scraper to bulk

Put as many products as you need in the product list, one ID or URL per line, or link a text file of product URLs in Start URLs. All products run in the same job and their reviews land in one dataset, each row tagged with its product ID. Set the max reviews per product to cap each one. For ongoing monitoring, schedule the actor and turn on **Only new reviews**: each run then returns just the reviews it has not returned to you before.

***

### ✨ Features

AliExpress Reviews Scraper fetches clean, structured reviews from AliExpress. It's ideal for supplier vetting, listing quality checks, complaint tracking and building review datasets for AI. It extracts, per review:

- **Review text and original text** – the review translated into your chosen language, with the buyer's own wording next to it
- **Star rating** – 1 to 5 stars plus the 0–100 score
- **Main issue** – defect, poor quality, shipping delay, size, wrong item, missing parts and more, with a confidence score
- **Sentiment** – a 0–4 level and a 0–1 score, with a flag when the text and the stars disagree
- **Photos** – full-size images and thumbnails
- **Follow-ups** – the buyer's later review and the seller's replies, with dates
- **Buyer country, variant bought and shipping method**

⚡ Filters by stars, date, keywords and reviewer country are applied before reviews count toward your limit, so you get the number of matching reviews you asked for.

***

### Use cases 💡

- **Dropshipper** — check 1-star reviews and issue labels before adding a supplier.
- **Brand owner** — track new complaints on your listings with only-new runs.
- **Product researcher** — compare star counts and review topics across competing products.
- **Quality manager** — find reviews that say "the battery drains quickly" with claim matching.
- **AI engineer** — index translated review text into a RAG pipeline for a shopping assistant.

Building an AI agent? [Connect AliExpress Reviews Scraper over MCP](#mcp-integration-for-ai-agents) and let it call the actor on its own.

***

### Why choose this actor?

- **Every written review of a product.** A recorded run asked for 500 reviews of one product and returned 418 — every written review across all 51 pages — in 11 seconds.
- **The detail behind each review.** A recorded review came back with its translation and original text, a 4-star rating and an 80/100 score, three attribute ratings, the shipping method, the variant bought, and a follow-up review with a photo.
- **5 sort orders, 9 review groups, 5 filters.** Sort by default, newest, oldest, lowest or highest rating; pick a star value, photos, follow-ups or local reviews; filter by star range, date, keywords, reviewer country and only new reviews.

***

### ⬇️ Input

![AliExpress Reviews Scraper input form with example values](https://api.apify.com/v2/key-value-stores/Lg9lp51Levfro6SrV/records/t-aliexpress-reviews-input.webp)

The actor accepts one or many AliExpress products as product IDs or product URLs (in the product list, in Start URLs, or both); at least one product is required.

| Parameter | Required | Type | Description | Example value |
|---|---|---|---|---|
| products | Yes, unless Start URLs is used | array | Product IDs or product URLs, one per line. | `["1005006079931969"]` |
| startUrls | No | array | Product URLs, or a link to a text file with one URL per line. | `[{"url": "https://www.aliexpress.com/item/1005006255429323.html"}]` |
| maxReviewsPerProduct | No | integer | Reviews to save per product; filtered reviews don't count. Default 20. | `50` |
| sort | No | string | `default`, `newest`, `oldest`, `lowest_rating`, `highest_rating`. Default `default`. | `"newest"` |
| reviewFilter | No | string | `all`, `5`, `4`, `3`, `2`, `1`, `image` (with photos), `additional` (with follow-up), `local` (from your country). Default `all`. | `"image"` |
| country | No | string | Two-letter country code for the `local` filter. Default `US`. | `"US"` |
| minRating | No | integer | Keep reviews with at least this many stars (1–5). | `1` |
| maxRating | No | integer | Keep reviews with at most this many stars (1–5). | `3` |
| sinceDate | No | string | Keep reviews published on or after this date. | `"2026-07-01"` |
| keywords | No | array | Keep reviews containing any of these words. | `["battery", "sound"]` |
| countries | No | array | Keep reviews from buyers in these countries. | `["US", "BR"]` |
| writtenOnly | No | boolean | Skip rating-only reviews with no text, photos or follow-up. Default true. | `true` |
| onlyNewReviews | No | boolean | Skip reviews returned to you in earlier runs. Default false. | `false` |
| onlyNewStateKey | No | string | Name of the remembered review list for only-new runs. Default `seen-reviews`. | `"my-earbuds"` |
| startPage | No | integer | Review page to start from (20 reviews per page). Default 1. | `1` |
| language | No | string | Language reviews are translated into: `EN`, `RU`, `PT`, `ES`, `FR`, `ID`, `IT`, `TH`, `JA`, `AR`, `VI`, `TR`, `DE`, `HE`, `KO`, `NL`, `PL`, `MX`, `CL`, `IN`. Default `EN`. | `"EN"` |
| analyzeReviews | No | boolean | Add sentiment and issue labels. Default true. | `true` |
| reportsClaim | No | string | A statement to check every review against (up to 300 characters). | `"the battery drains quickly"` |
| includeEvidence | No | boolean | Add the sentence that shows each label. Default false. | `false` |
| goal | No | string | Keep only reviews that help with this goal; others are left out and not billed. | `"how long the battery lasts"` |
| goalTokenBudget | No | integer | Size cap in AI tokens for reviews kept by the goal. | `4000` |
| hideBuyerDetails | No | boolean | Leave out buyer name and avatar. Default false. | `false` |
| includeProductRow | No | boolean | Add one product summary row per product. Default true. | `true` |
| maxConcurrency | No | integer | Review pages loaded at the same time (1–20). Default 4. | `4` |
| maxRetries | No | integer | Retries for a failed page (4–10). Default 5. | `5` |
| connectTimeoutSecs | No | integer | Seconds to wait for a connection. Default 8. | `8` |
| requestTimeoutSecs | No | integer | Seconds to wait for one page. Default 30. | `30` |
| proxyConfiguration | No | object | Proxy to start with; default is no proxy, and the actor switches to one by itself when blocked. | `{"useApifyProxy": false}` |

Accepted product formats:

- `1005006079931969`
- `https://www.aliexpress.com/item/1005006079931969.html`
- Regional and mobile AliExpress links that contain the product ID

#### Free plan limits

Users on the Apify free plan can fetch up to 20 reviews per run (all products together)
and 200 reviews per month. When the limit is reached the run finishes successfully with a
status message explaining the limit. Upgrade to any paid Apify plan to remove these limits.

#### Example input

```json
{
    "products": ["1005006079931969", "https://www.aliexpress.com/item/1005006255429323.html"],
    "startUrls": [{"url": "https://www.aliexpress.com/item/2251801850504415.html"}],
    "maxReviewsPerProduct": 50,
    "sort": "newest",
    "reviewFilter": "all",
    "country": "US",
    "minRating": 1,
    "maxRating": 3,
    "sinceDate": "2026-07-01",
    "keywords": ["battery", "sound"],
    "countries": ["US", "BR"],
    "writtenOnly": true,
    "onlyNewReviews": false,
    "onlyNewStateKey": "seen-reviews",
    "startPage": 1,
    "language": "EN",
    "analyzeReviews": true,
    "reportsClaim": "the battery drains quickly",
    "includeEvidence": false,
    "goal": "how long the battery lasts",
    "goalTokenBudget": 4000,
    "hideBuyerDetails": false,
    "includeProductRow": true,
    "maxConcurrency": 4,
    "maxRetries": 5,
    "connectTimeoutSecs": 8,
    "requestTimeoutSecs": 30,
    "proxyConfiguration": {"useApifyProxy": false}
}
```

***

### ⬆️ Output

![AliExpress Reviews Scraper output fields with example values](https://api.apify.com/v2/key-value-stores/Lg9lp51Levfro6SrV/records/t-aliexpress-reviews-output.webp)

Every review is one typed, normalized JSON item with the same schema on every run; export it as JSON (default), CSV or Excel. The run also fills two unbilled tables: **Products** (one row per product: title, image, average rating, rating percent, star counts, positive/neutral/negative shares, topics, attributes) and **Run status** (one row per product: reviews saved, pages read, filtered and duplicate rows, next page to continue from, errors); only review rows are billed. The examples below show one row from each table (lists shortened to their first entries).

#### Example output

Review row (main output table):

```json
[
    {
        "type": "review",
        "review_id": "30100683770930564",
        "product_id": "1005006079931969",
        "product_title": "Baseus Bowie MA10 Pro ANC Wireless Earphones 48dB Hybrid ANC Bluetooth 5.3 Earbuds IPX6 Waterproof 4-Mics ENC Sports Headphones",
        "review_url": "https://www.aliexpress.com/item/1005006079931969.html#nav-review",
        "title": "I received them good, the sound quality is very good but when you listen to bass music you can hear the high frequency…",
        "text": "I received them good, the sound quality is very good but when you listen to bass music you can hear the high frequency is cutting off, but i can't explain because for this price it is doing really well. I also used the eq adjustment to get the best out of it. So for this price i would say it is worth the money!",
        "original_text": "I received them good, the sound quality is very good but when you listen to bass music you can hear the high frequency is cutting off, but i can't explain because for this price it is doing really well. I also used the EQ adjustment to get the best out of it. so for this price I would say it is worth the money!",
        "translated": true,
        "language": "EN",
        "rating": 4,
        "rating_max": 5,
        "rating_score_100": 80,
        "author_name": "AliExpress Shopper",
        "author_avatar_url": null,
        "author_country": "US",
        "buyer_gender": null,
        "anonymous": true,
        "helpful_votes": 0,
        "unhelpful_votes": 0,
        "verified": true,
        "source": "aliexpress",
        "featured": false,
        "ai_generated": false,
        "review_type": "REVIEW",
        "variant": "Color:MA10 pro Ships From:China Mainland",
        "sku_id": "12000035973495072",
        "attributes": {"Quality of sound": "Fits ok", "Durability": "Fits ok", "User Friendly": "Good"},
        "logistics": "Aliexpress Selection Standard",
        "same_purchase_suggestion": "Buy the same",
        "images": null,
        "thumbnails": null,
        "image_count": 0,
        "responses": [
            {
                "type": "additional_review",
                "author": "buyer",
                "in_reply_to": "review",
                "text": "This is a really good product for on the motorcycle, they fit in my helmed and it doesn't hurt my ears.",
                "published_at": "2026-02-13T00:00:00.000Z",
                "days_after_review": 0,
                "images": ["https://ae-pic-a1.aliexpress-media.com/kf/A81f2c0f886cb4448bbb755016db288d0c.jpg"]
            }
        ],
        "published_at": "2026-02-12T00:00:00.000Z",
        "published_at_raw": "12 Feb 2026",
        "sentiment": {"level": 3, "score_0_1": 0.76, "confidence": 0.99, "rating_mismatch": false},
        "issue": {"label": "product_defect", "confidence": 0.75},
        "reports": null,
        "labels_evidence": null,
        "scraped_at": "2026-11-10T10:16:10Z"
    }
]
```

Products table:

```json
[
    {
        "type": "product",
        "product_id": "1005006079931969",
        "product_url": "https://www.aliexpress.com/item/1005006079931969.html",
        "product_title": "Baseus Bowie MA10 Pro ANC Wireless Earphones 48dB Hybrid ANC Bluetooth 5.3 Earbuds IPX6 Waterproof 4-Mics ENC Sports Headphones",
        "product_image": "https://ae-pic-a1.aliexpress-media.com/kf/Sd7dea848a34b465fae6d5d33be24f2daw.jpg",
        "product_type": "ORDINARY",
        "average_rating": 4.7,
        "rating_percent": 94.4,
        "ratings_total": 1013,
        "positive_count": 948,
        "positive_rate": 93.6,
        "neutral_count": 18,
        "neutral_rate": 1.8,
        "negative_count": 47,
        "negative_rate": 4.6,
        "rating_counts": {
            "5": 868,
            "4": 80,
            "3": 18,
            "2": 11,
            "1": 36
        },
        "rating_rates": {
            "5": 85.7,
            "4": 7.9,
            "3": 1.8,
            "2": 1.1,
            "1": 3.5
        },
        "filter_counts": {
            "additional": 30,
            "local": 37,
            "with_personal": 0,
            "image": 138,
            "all": 1011
        },
        "review_attributes": [
            {
                "name": "User Friendly",
                "count": 1870,
                "top_value": "Good",
                "values": [
                    {
                        "name": "Difficult",
                        "share_pct": 3.0,
                        "score": -1
                    },
                    {
                        "name": "Not bad",
                        "share_pct": 19.0,
                        "score": 0
                    },
                    {
                        "name": "Good",
                        "share_pct": 78.0,
                        "score": 1
                    }
                ]
            }
        ],
        "topics": [
            {
                "text": "excellent quality",
                "count": 68,
                "emotion": 1
            },
            {
                "text": "fast delivery",
                "count": 40,
                "emotion": 1
            }
        ],
        "scraped_at": "2026-11-10T10:46:53Z"
    }
]
```

Run status table:

```json
[
    {
        "type": "status",
        "product_id": "1005006079931969",
        "success": true,
        "error": null,
        "reviews_saved": 10,
        "reviews_total": 1013,
        "pages_fetched": 1,
        "total_pages": 51,
        "has_more": true,
        "next_page": 2,
        "duplicates": 0,
        "removed_empty": 3,
        "filtered_out": null,
        "truncated_to_max_items": 10,
        "held_back": null,
        "labels": {"presets": ["sentiment", "issue"], "rows": 10, "labelled": 10, "engine": "lexicon", "status": "complete"},
        "warnings": null,
        "duration_s": 0.6,
        "scraped_at": "2026-11-10T10:16:10Z"
    }
]
```

***

### How does it work?

The actor reads the same public review data any visitor sees on an AliExpress product page, without an AliExpress account or cookies. It loads review pages in parallel, 20 reviews per page, and walks them until it has the number of matching reviews you asked for. Reviews are saved to your dataset as soon as each page is read, so results appear while the run is still going. If a page fails, it retries with growing pauses; if AliExpress blocks the connection, it switches to a datacenter proxy and then to a residential proxy by itself. Sentiment and issue labels are computed by the actor on every review, with no outside service. The output keeps the same normalized field names on every run.

***

### How do you integrate AliExpress Reviews Scraper into your stack?

AliExpress Reviews Scraper works with what you already use: the REST API from any language, MCP for AI agents, and no-code tools.

#### Using AliExpress Reviews Scraper with the Apify API

```python
import requests

resp = requests.post(
    "https://api.apify.com/v2/actors/fastdataapi~aliexpress-reviews-scraper/run-sync-get-dataset-items",
    params={"token": "APIFY_TOKEN"},
    json={"products": ["1005006079931969"], "maxReviewsPerProduct": 50, "sort": "newest"},
)
for item in resp.json():
    if item["type"] == "review":
        print(item["rating"], item["text"])
```

*Works in Go, Ruby, Node.js, cURL — any language that can make an HTTP request.*

#### MCP integration for AI agents

Register the actor with one command:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=fastdataapi/aliexpress-reviews-scraper"
```

This registers AliExpress Reviews Scraper as a tool your agent can call directly. Your agent can then pull reviews for any product it is researching and read the ratings, issues and buyer comments on its own. It works in Claude Code, Cursor and Windsurf.

#### No-code tools (n8n, Make, LangChain)

**n8n:** add the Apify node and choose "Run an Actor" with `fastdataapi/aliexpress-reviews-scraper`, or use the HTTP Request node pointed at the run-sync endpoint with your token. The review rows arrive as items ready for the next node.

**Make:** use the Apify app's "Run an Actor" module, then "Get Dataset Items" to read the reviews. Map the rating and text fields into a sheet or a CRM.

**LangChain:** install `langchain-apify` and use `ApifyActorsTool("fastdataapi/aliexpress-reviews-scraper")`. Your agent gets the review rows as tool output.

***

### Is it legal to scrape AliExpress data?

Scraping publicly available AliExpress reviews is generally legal, as long as you collect only what is shown to any visitor. AliExpress Reviews Scraper returns only publicly available data — what any user sees without logging in. Reviews can include buyer display names and avatars; you can leave these out with the hide buyer details option. Under GDPR, scraping public data is generally permissible, but storing and using it must comply with local data-protection law. Consult legal counsel if your use case involves bulk storage of personal data.

***

### Frequently asked questions

#### What fields does AliExpress Reviews Scraper return?

It returns the review text with the original wording, the star rating, the buyer's country, review photos, and follow-up reviews with seller replies, plus sentiment and issue labels. See [the data fields section](#what-data-can-i-extract-with-aliexpress-reviews-scraper) for the full list.

#### Does AliExpress Reviews Scraper require an AliExpress account or login?

No. Only public review data is extracted. No credentials needed.

#### How fast does AliExpress Reviews Scraper run?

A recorded run returned 418 reviews of one product in 11 seconds, and another returned 60 reviews of 3 products in 17 seconds. Every run reads live data, not a cache.

#### What happens if a product is private or doesn't exist?

A product ID that doesn't exist returns a status row with zero reviews and no review rows. Text that is not an AliExpress product ID or URL is skipped and gets a status row with success set to false and an error code. Check the status row's success, error and reviews saved fields in your code.

#### Can I scrape multiple AliExpress products at once?

Yes. Put many product IDs or URLs in the product list, or link a text file of URLs in Start URLs; all products run in one job and one dataset.

#### Does AliExpress Reviews Scraper work with Claude, ChatGPT, and other AI agent tools?

Yes — AliExpress Reviews Scraper is available as an MCP tool. Register it in Claude Code, Cursor or Windsurf with:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=fastdataapi/aliexpress-reviews-scraper"
```

Any agent that can call an HTTP endpoint can use the REST API directly.

#### Does AliExpress Reviews Scraper return data in a format LLMs can use directly?

Yes. Typed, normalized JSON with consistent field names. No HTML parsing, no selectors. Pass it straight to an LLM, index it into a vector store, or feed it to an agent tool — no transformation step.

#### What happens when AliExpress changes its layout or updates its anti-bot system?

This actor is maintained and updated. When AliExpress changes, the actor is updated — your calls keep returning the same JSON schema with no changes on your end.

#### Can I use AliExpress Reviews Scraper without managing proxies or browser infrastructure?

Yes. Retries and proxy switching run on the actor's side: it starts without a proxy and moves to a datacenter, then a residential proxy when it is blocked. You send one request and get structured JSON back. No proxy accounts, no headless browser setup, no maintenance.

#### Which AliExpress review fields work best for AI training data and RAG indexing?

For RAG: the review text, the original text, the follow-up reviews and the seller replies. For training data: the star rating, the 0–100 score, the sentiment score, the issue label and the helpful votes. All fields are typed values — strings, numbers, booleans, lists — no normalization needed.

***

### Your feedback

Found a bug or missing a field? Let us know in the actor's Issues tab. Every report is read, and fixes ship as new versions of this actor.

# Actor input Schema

## `products` (type: `array`):

AliExpress products to scrape, one per line: a numeric product ID (1005006079931969) or a product URL (https://www.aliexpress.com/item/1005006079931969.html). Add as many as you like. Provide products here, in Start URLs, or both.

## `startUrls` (type: `array`):

Product URLs as a list, or a link to a text file with one URL per line. Used together with the product list above.

## `maxReviewsPerProduct` (type: `integer`):

How many reviews to save for each product. Reviews removed by your filters do not count. Free plan: up to 20 reviews per run (all products together) and 200 per month; paid plans have no limit.

## `language` (type: `string`):

Reviews are returned translated into this language; the original text is kept next to the translation.

## `sort` (type: `string`):

Order of the reviews. Lowest and highest rating go through the star ratings in turn (1 to 5 or 5 to 1) and replace the review filter below, except when the filter is a single star value: then that filter is kept and a rating sort has no effect.

## `reviewFilter` (type: `string`):

Show only one group of reviews: one star value, reviews with photos, reviews with a follow-up, or reviews from the country set below.

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

Two-letter country code (e.g. US, BR, FR). Used by the "From my country" filter.

## `minRating` (type: `integer`):

Keep reviews rated at least this many stars (1-5). Leave empty for no lower bound.

## `maxRating` (type: `integer`):

Keep reviews rated at most this many stars (1-5). Leave empty for no upper bound.

## `sinceDate` (type: `string`):

Keep reviews published on or after this date. With "Newest first" the run stops paging once reviews get older than this date.

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

Keep reviews whose text (translated or original) contains any of these words, case-insensitive.

## `countries` (type: `array`):

Keep reviews written by buyers from these countries, as two-letter codes (e.g. US, BR).

## `writtenOnly` (type: `boolean`):

Skip rating-only reviews that have no text, photos or follow-up.

## `onlyNewReviews` (type: `boolean`):

Skip reviews this actor already returned to you in earlier runs. Review IDs are remembered in a key-value store in your Apify account.

## `onlyNewStateKey` (type: `string`):

Name of the remembered review list used by Only new reviews. Use different names to track separate projects. Letters, digits and !-\_.'() only.

## `startPage` (type: `integer`):

Page of reviews to start from (20 reviews per page). The status row gives the next page to continue from when more reviews are left.

## `analyzeReviews` (type: `boolean`):

Add a sentiment score (0-4) and the main problem the review raises (defect, shipping delay, size, wrong item...) to every review.

## `reportsClaim` (type: `string`):

A short statement, e.g. "the battery drains quickly". With Sentiment and issue labels on, every review gets the probability (0-1) that it says this; with labels off the claim is ignored. Up to 300 characters; reviews and claim should use the same alphabet.

## `includeEvidence` (type: `boolean`):

For each label, add the sentence from the review that shows it.

## `goal` (type: `string`):

Keep only the reviews that help with this goal, e.g. "how long the battery lasts". The first and last review and uncertain matches are kept; the others are left out and not charged. Up to 300 characters.

## `goalTokenBudget` (type: `integer`):

Optional size cap (in AI tokens, about 4 characters each) for the reviews kept by Research goal; the least relevant are left out first.

## `hideBuyerDetails` (type: `boolean`):

Leave out the buyer's name and avatar.

## `includeProductRow` (type: `boolean`):

Save one row per product (title, image, average rating, star counts, positive/neutral/negative shares, review topics and attributes) in the Products table of the output.

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

How many review pages are loaded at the same time.

## `maxRetries` (type: `integer`):

How many times a failed page is tried again. At least 4, so a blocked page can move from a direct connection to a datacenter proxy and then get 3 residential proxy tries.

## `connectTimeoutSecs` (type: `integer`):

How long to wait for a connection before trying again.

## `requestTimeoutSecs` (type: `integer`):

How long to wait for one page in total.

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

Proxy to start with. Without one, the actor connects directly and moves to a datacenter, then a residential proxy if the site blocks it.

## Actor input object example

```json
{
  "products": [
    "1005006079931969"
  ],
  "maxReviewsPerProduct": 20,
  "language": "EN",
  "sort": "default",
  "reviewFilter": "all",
  "country": "US",
  "writtenOnly": true,
  "onlyNewReviews": false,
  "onlyNewStateKey": "seen-reviews",
  "startPage": 1,
  "analyzeReviews": true,
  "includeEvidence": false,
  "hideBuyerDetails": false,
  "includeProductRow": true,
  "maxConcurrency": 4,
  "maxRetries": 5,
  "connectTimeoutSecs": 8,
  "requestTimeoutSecs": 30,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `reviewText` (type: `string`):

No description

## `buyers` (type: `string`):

No description

## `ratings` (type: `string`):

No description

## `media` (type: `string`):

No description

## `followUps` (type: `string`):

No description

## `labels` (type: `string`):

No description

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

No description

## `runStatus` (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 = {
    "products": [
        "1005006079931969"
    ],
    "maxReviewsPerProduct": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("fastdataapi/aliexpress-reviews-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 = {
    "products": ["1005006079931969"],
    "maxReviewsPerProduct": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("fastdataapi/aliexpress-reviews-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 '{
  "products": [
    "1005006079931969"
  ],
  "maxReviewsPerProduct": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call fastdataapi/aliexpress-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,fastdataapi/aliexpress-reviews-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/3u4g3bKJu5DeEgSHG/builds/4dgvIFzgqjnKTKoW2/openapi.json
