{ "openapi": "3.0.1", "info": { "title": "AliExpress Product Details & Search Scraper 🛒 (with reviews)", "description": "AliExpress product details and search results: every variant with price and stock, shipping cost and delivery days for your country, store rating and followers, sold count, specs, images, plus reviews. Paste URLs or type keywords. No login, no API key.", "version": "0.1", "x-build-id": "eaeEuugM3XoMV3CYA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tagadanar~aliexpress-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tagadanar-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/tagadanar~aliexpress-scraper/runs": { "post": { "operationId": "runs-sync-tagadanar-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/tagadanar~aliexpress-scraper/run-sync": { "post": { "operationId": "run-sync-tagadanar-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": { "productUrls": { "title": "Product URLs or IDs", "type": "array", "description": "AliExpress product links or bare product IDs, one per line, e.g. https://www.aliexpress.com/item/1005009463232289.html or 1005009463232289. aliexpress.us and m.aliexpress.com links work too. Each one returns a full product row: every variant with its price and stock, shipping to your country, store details, specs and images.", "items": { "type": "string" } }, "searchQueries": { "title": "Search keywords or search URLs", "type": "array", "description": "What you would type in the AliExpress search box, one per line (e.g. phone case, wireless earbuds), or a pasted AliExpress search / category URL (its filters are kept). Each result comes back with its rank.", "items": { "type": "string" } }, "maxItemsPerSearch": { "title": "Max results per search", "minimum": 1, "maximum": 1200, "type": "integer", "description": "How many products to take from each search, in AliExpress's order (60 per page).", "default": 20 }, "sortBy": { "title": "Sort search results by", "enum": [ "best", "orders", "price_asc", "price_desc" ], "type": "string", "description": "Same choices as the sort bar on AliExpress.", "default": "best" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Only search results at or above this price, in the currency below (whole units)." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Only search results at or below this price, in the currency below (whole units)." }, "includeProductDetails": { "title": "Full product details for search results", "type": "boolean", "description": "Turn a search into full product rows (variants, stock, shipping, store, specs). Each result is then billed as a product instead of a search result.", "default": false }, "maxReviewsPerProduct": { "title": "Reviews per product", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Also collect up to this many reviews for every product row (rating, date, text and English translation, variant bought, buyer country, photos). 0 = no reviews.", "default": 0 }, "shipTo": { "title": "Ship to (country)", "enum": [ "US", "GB", "DE", "FR", "ES", "IT", "NL", "BE", "PL", "PT", "SE", "CH", "AT", "IE", "CZ", "DK", "FI", "NO", "GR", "HU", "RO", "IL", "TR", "SA", "AE", "CA", "MX", "BR", "CL", "CO", "AU", "NZ", "JP", "KR", "SG", "MY", "PH", "TH", "VN", "ID", "ZA", "UA", "KZ" ], "type": "string", "description": "Prices, stock, shipping cost and delivery dates are the ones AliExpress shows a shopper in this country.", "default": "US" }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "CAD", "AUD", "BRL", "MXN", "PLN", "CHF", "SEK", "NOK", "DKK", "CZK", "HUF", "TRY", "ILS", "SAR", "AED", "JPY", "KRW", "NZD", "CLP", "ZAR", "UAH", "KZT" ], "type": "string", "description": "Currency for every price.", "default": "USD" }, "language": { "title": "Language", "enum": [ "en_US", "fr_FR", "de_DE", "es_ES", "it_IT", "pt_BR", "nl_NL", "pl_PL", "tr_TR", "ja_JP", "ko_KR", "he_IL", "ar_MA" ], "type": "string", "description": "Language of titles, specs and sold labels (AliExpress's own translation).", "default": "en_US" } } }, "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 } } } } } } } } } }