{ "openapi": "3.0.1", "info": { "title": "AliExpress Scraper โ€” Products, Prices & Reviews ยท $0.8/1K", "description": "AliExpress Scraper at $0.80 per 1,000 products: search by keyword or paste any URL and get price, discount, sold count, rating, image, tags and store as clean JSON or CSV. Product, search, mobile, regional, app and share links all work. Optional reviews, currency and country. No login.", "version": "0.0", "x-build-id": "x1hzDGlu2I6MOQVFe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~aliexpress-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-aliexpress-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/memo23~aliexpress-scraper/runs": { "post": { "operationId": "runs-sync-memo23-aliexpress-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/memo23~aliexpress-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-aliexpress-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search on AliExpress (e.g. \"wireless earbuds\", \"mechanical keyboard\"). Each becomes a wholesale search and is paginated (60 products per page) up to your Max items limit.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct AliExpress URLs. Accepts product pages (`/item/.html`), search/wholesale pages (`/w/wholesale-...`), mobile & regional domains (`m.`, `de.`, `aliexpress.us`), app deep links (`aliexpress://...`) and short share links (`a.aliexpress.com/_xxx`). All are auto-normalized.", "items": { "type": "string" } }, "scrapeDetails": { "title": "Scrape product details (variants, stock, shipping, seller)", "type": "boolean", "description": "Adds every variant with its own price and stock, shipping options and delivery dates to your country, the seller card, specs, gallery and video. One extra request per product, charged as additional data only when details come back. Leave off if the search-level fields are enough.", "default": false }, "currency": { "title": "Price currency", "enum": [ "USD", "EUR", "GBP", "BRL", "AUD", "CAD", "RUB", "JPY", "MXN", "INR", "AED", "SAR" ], "type": "string", "description": "Currency for all prices in the output. Titles remain English regardless.", "default": "USD" }, "country": { "title": "Shipping region", "enum": [ "US", "GB", "DE", "FR", "ES", "IT", "NL", "BR", "AU", "CA", "RU", "MX", "IN", "AE", "SA" ], "type": "string", "description": "ISO-2 country code used for shipping estimates and regional promo prices.", "default": "US" }, "sortBy": { "title": "Sort by", "enum": [ "default", "orders", "price_asc", "price_desc", "newest" ], "type": "string", "description": "Order AliExpress returns results in. orders puts the most-sold products first, newest the most recently listed.", "default": "default" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Lowest price to include, in the output currency." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Highest price to include, in the output currency." }, "freeShipping": { "title": "Free shipping only", "type": "boolean", "description": "Only listings AliExpress marks as free shipping to the selected country.", "default": false }, "minRating": { "title": "Min rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Drop products rated below this many stars (1โ€“5). Products with no rating yet are kept." }, "minOrders": { "title": "Min orders", "minimum": 0, "type": "integer", "description": "Drop products with fewer orders than this. AliExpress shows counts as floors (\"1,000+ sold\" counts as 1000). Products with no count shown are kept." }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Fetch buyer reviews for every product: rating, English text and the original, date, buyer country, variant bought, photos and helpful votes, plus the product's star breakdown. One extra request per 20 reviews per product.", "default": false }, "maxReviews": { "title": "Max reviews per product", "minimum": 1, "maximum": 500, "type": "integer", "description": "Cap per product when Include reviews is on. Rounded up to whole pages of 20.", "default": 20 }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Hard cap on the number of products returned across all queries and URLs. One search page yields up to 60 products; raise this to paginate deeper.", "default": 100 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "type": "integer", "description": "Maximum number of detail pages fetched in parallel (only relevant when \"Scrape product detail pages\" is on).", "default": 8 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies are REQUIRED โ€” AliExpress blocks datacenter IPs. The actor ships with a working residential pool by default; override here only if you have your own residential proxy." } } }, "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 } } } } } } } } } }