MCP + API · kestrel/aliexpress-reviews-scraper

AliExpress Reviews Scraper: Product Reviews, Ratings & Feedback

Scrape AliExpress product reviews by URL or item id: star rating, buyer feedback translated into 16 languages, buyer photos, country, SKU variant. Date, keyword and star filters, new-review monitoring, free sentiment analysis. For dropshipping product research. No login. API and MCP ready.

Open Actor Download MCP config

Connect this tool

Add this URL as a remote MCP server in your client, then sign in to Apify. For a client-specific setup, use Apify's configurator.

https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/aliexpress-reviews-scraper
Generic MCP client configuration
{
  "mcpServers": {
    "kestrel-aliexpress-reviews-scraper": {
      "url": "https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/aliexpress-reviews-scraper"
    }
  }
}

Understand the output before you run

One row per AliExpress buyer review (charged), plus a free product context row and a free status row per target.

Declared dataset fields and row types · Output locations and dataset links

Use the declared dataset schema for item fields; the output schema describes where results are stored. Optional fields may be null or absent. If an integration shows a sampled schema without an optional field, check this declaration, the Actor instructions and actual returned rows before concluding that the field is unsupported.

Inspect 82 declared output fields
FieldTypeMeaning
typestringreview | product | status | insights (insights rows only with Analyze reviews on)
targetstring / nullThe input value (product URL or item id) this row came from
product_idstring / nullAliExpress's numeric item id (the number in /item/<id>.html)
product_titlestring / nullProduct title as AliExpress lists it
product_urlstring / nullThe product's page on aliexpress.com
product_imagestring / nullMain product image URL (product rows)
review_idstring / nullAliExpress's numeric evaluation id, unique per review
review_datestring / nullPublication date, YYYY-MM-DD, parsed back from the language the review was requested in
review_date_rawstring / nullThe date exactly as AliExpress wrote it, e.g. "02 Mar 2026" or "02 мар 2026"
ratingnumber / nullStar rating, 1-5 (on product rows, the product's average as a decimal such as 4.2)
rating_100integer / nullAliExpress's own 0-100 score behind the stars: 100 = 5 stars, 80 = 4 stars, and so on
textstring / nullThe review exactly as the buyer wrote it; null when they left stars only
text_translatedstring / nullAliExpress's machine translation of the review into the language the run asked for
languagestring / nullLanguage code of the served text, e.g. en, ru, es
buyer_namestring / nullBuyer display name, masked by AliExpress ("S***l") or "AliExpress Shopper" when they stayed anonymous
buyer_countrystring / nullBuyer country as an ISO-2 code, e.g. US, BR, PL
buyer_genderstring / nullBuyer gender when AliExpress publishes it
buyer_anonymousboolean / nulltrue when the buyer hid their identity
buyer_avatarstring / nullBuyer avatar image URL, when there is one
sku_idstring / nullAliExpress's numeric id of the exact variant the buyer bought
sku_infostring / nullThe variant in words, e.g. "Color:LP40 white" — which colour or size the review is actually about
imagesarray / nullFull-size URLs of the photos the buyer attached to the review
image_countinteger / nullHow many photos the review carries
logisticsstring / nullThe shipping method the order used, e.g. "AliExpress Selection Standard Shipping"
helpful_votesinteger / nullHow many shoppers marked the review helpful
unhelpful_votesinteger / nullHow many shoppers marked the review unhelpful
attributesobject / nullThe structured attributes AliExpress asked this buyer to rate, e.g. {"Quality of sound": "Good", "Durability": "Fits ok"}
follow_up_textstring / nullThe follow-up review the buyer added later, in their own words
follow_up_translatedstring / nullMachine translation of the follow-up review
follow_up_datestring / nullDate of the follow-up review, YYYY-MM-DD
follow_up_daysinteger / nullHow many days after the first review the follow-up was written — the durability signal
follow_up_imagesarray / nullPhotos attached to the follow-up review
featuredboolean / nulltrue when AliExpress promotes this review to the top of the product page
ai_generatedboolean / nullAliExpress's own flag for a review it believes was written by AI
sentimentstring / nullWith Analyze reviews on: positive, neutral or negative — the star rating pulled toward what the words of the review say (review rows)
sentiment_scorenumber / nullWith Analyze reviews on: -1 (angry) to 1 (delighted); the stars on that scale, averaged with the balance of praise and complaint words when the review has any (review rows)
rating_text_mismatchboolean / nullWith Analyze reviews on: true when a 4 or 5 star review reads as a complaint — the AliExpress habit an average rating hides (review rows)
topicsarray / nullWith Analyze reviews on. Review rows: which of quality, delivery, packaging, size_fit, description_match, value, durability, functionality, seller_service, authenticity, damaged_or_missing the review talks about. Insights rows: every topic with how many reviews raise it, how many of those are positive and negative, and their average rating
reviews_analyzedinteger / nullHow many delivered reviews the insights row summarises (insights rows)
avg_ratingnumber / nullAverage star rating of the analysed reviews — of the reviews this run delivered, after your filters, not of the whole product (insights rows)
sentiment_positiveinteger / nullAnalysed reviews that read positive (insights rows)
sentiment_neutralinteger / nullAnalysed reviews that read neutral (insights rows)
sentiment_negativeinteger / nullAnalysed reviews that read negative (insights rows)
avg_sentiment_scorenumber / nullAverage sentiment score, -1 to 1 (insights rows)
rating_text_mismatchesinteger / nullHow many 4-5 star reviews read as complaints (insights rows)
top_complaintsarray / nullUp to five topics with the most negative reviews, worst first (insights rows)
top_praisearray / nullUp to five topics with the most positive reviews (insights rows)
by_variantarray / nullThe ten most-reviewed SKU variants with review count, average rating and negative reviews each — which colour, size or plug is the bad one (insights rows)
by_countryarray / nullThe ten biggest buyer countries with review count, average rating and negative reviews each (insights rows)
by_montharray / nullReview count, average rating and negative reviews per calendar month, oldest first — is the product getting better or worse (insights rows)
with_photosinteger / nullAnalysed reviews carrying buyer photos (insights rows)
follow_upsinteger / nullAnalysed reviews with a follow-up review (insights rows)
follow_ups_negativeinteger / nullFollow-up reviews whose own words are more complaint than praise — the durability signal (insights rows)
rating_percentnumber / nullThe product's average rating as a percentage, AliExpress's own number (product rows)
reviews_totalinteger / nullHow many reviews AliExpress says the product has (product rows)
reviews_fetchedinteger / nullReviews read in this run for the product, before filters (product rows)
five_starinteger / nullNumber of 5-star reviews (product rows)
four_starinteger / nullNumber of 4-star reviews (product rows)
three_starinteger / nullNumber of 3-star reviews (product rows)
two_starinteger / nullNumber of 2-star reviews (product rows)
one_starinteger / nullNumber of 1-star reviews (product rows)
positive_countinteger / nullReviews AliExpress counts as positive, 4-5 stars (product rows)
neutral_countinteger / nullReviews AliExpress counts as neutral, 3 stars (product rows)
negative_countinteger / nullReviews AliExpress counts as negative, 1-2 stars (product rows)
positive_ratenumber / nullShare of positive reviews as a percentage (product rows)
negative_ratenumber / nullShare of negative reviews as a percentage (product rows)
with_photos_countinteger / nullHow many of the product's reviews carry buyer photos (product rows)
with_follow_up_countinteger / nullHow many carry a follow-up review written later (product rows)
same_country_countinteger / nullHow many were written by buyers in the country the run asked as (product rows)
product_typestring / nullAliExpress's own product classification, e.g. ORDINARY (product rows)
review_attributesarray / nullThe structured attributes buyers rated the product on, with how many said each thing — the fastest read on what people love and hate (product rows)
review_topicsarray / nullThe topics AliExpress itself mined from the review texts — 'poor sound quality', 'fast delivery' — each with its sentiment (positive, negative or neutral) and how many reviews raise it: the product's praise and complaints at a glance (product rows)
statusstring / nullok | no_reviews | not_found | duplicate | error (status rows)
reviewsinteger / nullReviews delivered and charged for this target (status rows)
filteredinteger / nullReviews dropped by the filters, never charged (status rows)
already_seeninteger / nullWith Only new reviews on: how many reviews passed the filters but were already delivered by an earlier run, so were skipped and not charged (status rows)
pagesinteger / nullRequests made for this target (status rows)
totalinteger / nullReviews AliExpress lists for the product (status rows)
repeatsinteger / nullReviews AliExpress served twice across its shuffled result shards and this run dropped (status rows)
duplicatesinteger / null1 when this target resolved to a product another target already covers (status rows)
errorstring / nullWhy a target failed (status rows)
fetched_atstring / nullUTC timestamp of the request

Start with a small sample

Use call-actor with the JSON below. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Change the target to match your request. This input validates against build 1.1.9; it is not a promise that the source has matching rows today.

{
  "actor": "kestrel/aliexpress-reviews-scraper",
  "input": {
    "productUrls": [
      "https://www.aliexpress.com/item/1005006255429323.html"
    ],
    "maxReviewsPerProduct": 3,
    "reviewsFilter": "all"
  },
  "callOptions": {
    "maxTotalChargeUsd": 0.25,
    "timeout": 300
  },
  "waitSecs": 30
}

After completion, use get-dataset-items with storages.datasets.default.id. If still running, poll get-actor-run using the returned runId. Check status rows and errors before treating an empty dataset as no matches.

Call from Python, JavaScript or REST

Python SDK 3 example · JavaScript SDK 2 example · curl + jq example. Each uses this same small input, reads APIFY_TOKEN from your environment, sets a five-minute run timeout and exports all dataset row types as JSON Lines. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Inspect the run and source status before treating results as complete. Installation and usage.

Pricing and limits

Current listed event prices in USD. Some Actors charge for successful source checks even when no output rows match. The event descriptions below define those differences.

EventUSD eachWhat is charged
review$0.003One AliExpress buyer review (row keys review_id, rating = 1-5, text, text_translated = language you pick, buyer_name, buyer_country, sku_info = variant, images = photos, logistics = shipping method, follow_up_text, helpful_votes, attributes = attributes rated, review_date): $3 per 1,000 reviews. Not charged: the product row (average rating, star histogram, review topics), insights rows, status rows, reviews your filters remove (stars, date, keyword, country, photos, text), reviews an earlier onlyNewReviews run already delivered, duplicate targets, products with no reviews, unknown item ids, bad input. No start fee; proxy and compute are included in the event price. The run stops at the maximum cost per run you set when starting it (Apify run option maxTotalChargeUsd), never above it.

Contracts for agents

Public contract checked 2026-11-11. Active build: 1.1.9. Refresh live details before a large or recurring run.