{ "openapi": "3.0.1", "info": { "title": "AliExpress Reviews Scraper - Ratings, Photos & Translations", "description": "Reviews of any AliExpress product as data: stars, date, text with English translation, buyer country, variant bought, shipping method, helpful votes, photo URLs and follow-up comments. Or one summary row per product with star counts and review topics. No login, no browser.", "version": "1.0", "x-build-id": "dGCoHxd2l7fgpgBs7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mochiboo~aliexpress-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mochiboo-aliexpress-reviews-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/mochiboo~aliexpress-reviews-scraper/runs": { "post": { "operationId": "runs-sync-mochiboo-aliexpress-reviews-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/mochiboo~aliexpress-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-mochiboo-aliexpress-reviews-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "products" ], "properties": { "products": { "title": "Product URLs or item IDs", "minItems": 1, "type": "array", "description": "AliExpress products to read the reviews of, one per entry: a product URL such as https://www.aliexpress.com/item/1005006691583009.html or just the item ID (1005006691583009). Use the item ID from aliexpress.com product URLs. Left as it is, a run reads the two example products.", "items": { "type": "string" }, "default": [ "https://www.aliexpress.com/item/1005006691583009.html", "1005010399232494" ] }, "outputMode": { "title": "What to return", "enum": [ "reviews", "summary" ], "type": "string", "description": "One row per review (default), or one summary row per product: average rating, total reviews, 1-5 star counts, positive %, counts with photos / follow-ups / from the selected country, and AliExpress's own review topics. Summary mode ignores the review filters and the per-product review limit (it reads one page per product); maxResults still caps the number of summary rows.", "default": "reviews" }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Counts delivered rows. Hard cap 5000.", "default": 100 }, "onlyWithText": { "title": "Only reviews with written text", "type": "boolean", "description": "Skips star-only reviews (no words). They are never charged. Turn off to get every review.", "default": true }, "filter": { "title": "Which reviews", "enum": [ "all", "image", "additional", "local" ], "type": "string", "description": "All reviews, only reviews with photos, only reviews with a follow-up comment, or only buyers from the selected country. Summary mode ignores this setting.", "default": "all" }, "country": { "title": "Country (2 letters)", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "2-letter country code. It sets the country of the 'Only buyers from the selected country' filter and of the summary's fromSelectedCountry count, and with US (the default) AliExpress also lists American buyers first, so a capped run can be mostly American buyers; another code such as DE gives a more mixed list.", "default": "US" }, "minRating": { "title": "Minimum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews with at least this many stars (1 to 5).", "default": 1 }, "maxRating": { "title": "Maximum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews with at most this many stars (1 to 5).", "default": 5 }, "reviewsSince": { "title": "Only reviews on or after", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "YYYY-MM-DD. AliExpress has no date sort, so the actor reads pages (at most 250 pages = 5,000 reviews per product, all AliExpress serves) until your per-product limit is reached and keeps the reviews on or after this date. A recent date on a product with thousands of reviews can need many pages.", "default": "" }, "maxResults": { "title": "Max rows per run", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard cap 100000.", "default": 2000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for the requests. The default Apify datacenter proxy is what the actor was tested with.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }