{
"openapi": "3.0.1",
"info": {
"title": "AliExpress Reviews Scraper | Feedback, Ratings and Photos",
"description": "AliExpress reviews scraper (速卖通, 全球速卖通): 100 reviews in 1 second, 36 fields each. Paste a product link, product ID or keyword and get stars, text, English translation, buyer photos, variant bought, country, helpful votes, seller reply and rating breakdown. No account. Export JSON, CSV or Excel.",
"version": "1.0",
"x-build-id": "H4TjOZFJHkPhdbSpj"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~aliexpress-reviews-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-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/silentflow~aliexpress-reviews-scraper/runs": {
"post": {
"operationId": "runs-sync-silentflow-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/silentflow~aliexpress-reviews-scraper/run-sync": {
"post": {
"operationId": "run-sync-silentflow-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",
"properties": {
"startUrls": {
"title": "🔗 AliExpress links",
"type": "array",
"description": "Links copied from AliExpress, one per line:
Product pages (https://www.aliexpress.com/item/1005007011478793.html): the reviews of that product, up to every one it has.
Search results (https://www.aliexpress.com/w/wholesale-phone-case.html): the reviews of the products listed, in the order AliExpress ranks them. Links from aliexpress.us and regional sites work too.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"productIds": {
"title": "🆔 Product IDs",
"type": "array",
"description": "AliExpress product IDs, one per line: the number in a product link (1005007011478793). Long IDs starting with 3256 and older short IDs work too. A product without reviews is named in the log and adds no row.",
"items": {
"type": "string"
}
},
"keywords": {
"title": "🔎 Keywords",
"type": "array",
"description": "Search AliExpress and collect the reviews of the products it returns, one keyword per line (phone case, wireless earbuds). English keywords match best. Products are read in the order shoppers see them; set Max reviews per product to cover more of them.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "🔢 Max reviews",
"minimum": 1,
"type": "integer",
"description": "How many reviews to save for the whole run. A popular product has thousands: 100 gives a quick sample, 5000 every review of a product that has up to 5,000. Above that, the run goes on star level by star level. Cost scales with the reviews delivered.",
"default": 100
},
"maxReviewsPerProduct": {
"title": "📦 Max reviews per product",
"minimum": -1,
"type": "integer",
"description": "Stop each product after this many reviews and move to the next one (20 with a keyword covers five products for 100 reviews). 0 reads each product to its last review, within Max reviews.",
"default": 0
},
"reviewFilter": {
"title": "⭐ Reviews to include",
"enum": [
"all",
"5",
"4",
"3",
"2",
"1",
"photos",
"additional"
],
"type": "string",
"description": "Keep one star level to study complaints (1 star) or praise (5 stars), only the reviews with buyer photos, or only those the buyer came back to update after using the product.",
"default": "all"
},
"sort": {
"title": "↕️ Sort by",
"enum": [
"default",
"latest"
],
"type": "string",
"description": "Recommended is the order AliExpress shows shoppers first on the product page. Most recent starts from the latest review, the one to use for monitoring.",
"default": "default"
},
"withTextOnly": {
"title": "💬 Written reviews only",
"type": "boolean",
"description": "Leave out the reviews that are only a star rating, so every row has text to read or analyse. Ratings left out never reach your dataset; the run reads further to reach Max reviews.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}