leoworks/aliexpress-reviews-classifier
leoworks--aliexpress-reviews-classifierThis tool calls the Actor "leoworks/aliexpress-reviews-classifier" and retrieves its output results. Actor description: AliExpress reviews scraper with review analysis: translation, stars, country, photos; AliExpress review complaints and sentiment. Use for known products; for keyword search use leoworks/aliexpress-search-scraper. productUrls or IDs. No login, ~8 min/1,000 reviews, pay per review.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"productUrls": "<productUrls>"
},
"name": "leoworks--aliexpress-reviews-classifier"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | Two-letter country code used for the request (affects which reviews AliExpress shows first and the translation language base). Default US. Example values: "US" | US |
| keywords | No | Keep only reviews whose text, English translation or follow-up contains one of these words (not case-sensitive), e.g. "broken", "battery", "size". | |
| maxStars | No | Keep only reviews with at most this many stars — e.g. 3 to read only the critical ones before sourcing a product. | |
| minStars | No | Keep only reviews with at least this many stars. Leave empty for all. | |
| waitSecs | No | Max seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget. | |
| monitorKey | No | Any name for this watch list, e.g. `my-suppliers`. Run again with the same key and each product row gets `previousRunAt`, `ratingDelta`, `newReviews` and `newCriticalIssues` (new reviews that need action) — the change since the last run with that key; the first run only saves the baseline. Leave empty to switch comparison off. [Description truncated] | |
| healthCheck | No | Internal: fail the run when results look degraded (used by the developer's scheduled checks). | |
| productUrls | Yes | **REQUIRED** AliExpress product pages (any site: www.aliexpress.com, aliexpress.us, ko.aliexpress.com …) or product IDs, e.g. https://www.aliexpress.com/item/1005008549911526.html or 1005008549911526. Example values: ["https://www.aliexpress.com/item/1005008549911526.html"] | |
| customLabels | No | Up to 10 yes/no criteria in plain language, e.g. "arrived broken or damaged", "mentions the battery", "looks different from the photos". Each classified review gets a probability and `matched` per label. Included in the classification price. | |
| photoJudging | No | Adds `photoEvidence` (supports_complaint_product, supports_complaint_packaging, damage_seen_text_silent, no_evidence, not_product_photo) and puts photo-backed product defects, then photo-backed packaging damage, at the top of ACTION_QUEUE.csv. "Only reviews with a complaint or 3 stars or fewer" judges far fewer photos and is the recommended setting. Example values: "off" | off |
| photoMaxSide | No | Longest side in pixels requested from the photo server (512, 768 or 1024; other values are rounded). Smaller is faster; photos under 280 pixels on the short side are skipped. Example values: 768 | |
| reviewFilter | No | Reviews come in AliExpress' default order. Star and date sorting are not offered by the source. "Only reviews from buyers in the shipping country" uses the Shipping country under Advanced. Example values: "all" | all |
| buyerCountries | No | Keep only reviews from buyers in these countries (two-letter codes, e.g. US, FR, BR). | |
| maxConcurrency | No | Products processed in parallel. Example values: 5 | |
| classifyReviews | No | Add complaint types (delivery, quality/defect, size/fit, price/value, customer service, packaging, no effect, skin/body reaction, other), sentiment and purchase motive to each review. Reviews in other languages are classified from AliExpress' English translation. Adds $0.5 per 1,000 classified reviews on top of the $1.5 per 1,000 collection price — turn off for collection only. Example values: true | |
| includeStarOnly | No | AliExpress has many reviews with a star rating but no text or photos. They are skipped (not charged) by default; turn this on to collect them too (charged as review). | |
| reviewsNewerThan | No | A date (`2026-09-01`) or a period (`30 days`, `6 months`). | |
| reviewsPerProduct | No | Maximum reviews to collect for each product (charged per review: $1.5 per 1,000, or $2.0 per 1,000 with AI classification). The form starts at 20 for a quick, low-cost first run; raise it up to 5,000 (default when omitted via API: 100). Example values: 20 | |
| complaintThreshold | No | Minimum probability (0–1) for a complaint type to be reported. Example values: 0.5 | |
| maxPhotosPerReview | No | The first photos of each review. With "All reviews that have photos", at most 2 photos per review are judged. Example values: 2 | |
| proxyConfiguration | No | Default Apify datacenter proxy works. Example values: {"useApifyProxy":true} | |
| residentialFallback | No | Retry failing requests through residential proxy in the shipping country. Example values: true |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tip | No | Advisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key | |
| runId | Yes | Actor run ID | |
| stats | No | Run statistics | |
| status | Yes | Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED | |
| actorId | Yes | Stable Apify Actor ID from the run record | |
| summary | Yes | Past-tense summary of the run state | |
| exitCode | No | Actor process exit code; populated for terminal states (especially FAILED) | |
| nextStep | Yes | One primary follow-up action with identifiers interpolated | |
| storages | Yes | Dataset and key-value store metadata, keyed by alias. "default" is always the primary entry. | |
| actorName | No | "username/actor-name" | |
| startedAt | No | ISO timestamp when the run started | |
| finishedAt | No | ISO timestamp when the run finished (terminal states only) | |
| statusMessage | No | Pass-through from Apify run.statusMessage | |
| apifyConsoleUrl | No | Personalized Apify Console link to the run; present only for Console sessions |