{ "openapi": "3.0.1", "info": { "title": "AliExpress Product Scraper", "description": "Extract product data from AliExpress.com anonymously — no login needed. Search by keyword for price, sold count and store info, or pull full product details including specs, images and store profile by product ID. Batch multiple queries or IDs in one run. First 10 rows of every run are free.", "version": "1.0", "x-build-id": "HQKk0jmRrtbNuec0W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mrdoe~aliexpress-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mrdoe-aliexpress-product-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/mrdoe~aliexpress-product-scraper/runs": { "post": { "operationId": "runs-sync-mrdoe-aliexpress-product-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/mrdoe~aliexpress-product-scraper/run-sync": { "post": { "operationId": "run-sync-mrdoe-aliexpress-product-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": [ "operation" ], "properties": { "operation": { "title": "Operation", "enum": [ "search", "productDetails" ], "type": "string", "description": "Which AliExpress data to scrape. One operation per run.", "default": "search" }, "query": { "title": "Search query (optional)", "type": "string", "description": "Keyword to search AliExpress, e.g. \"coffee maker\". Used by the search operation. Defaults to a demo query if left blank.", "default": "coffee maker" }, "queries": { "title": "Search queries - batch (optional)", "type": "array", "description": "Many keywords in one run. Wins over \"query\" when filled. Duplicates and blanks are dropped.", "items": { "type": "string" } }, "productId": { "title": "Product ID or item URL (optional)", "type": "string", "description": "A numeric AliExpress product ID (e.g. \"1005005452938708\") or a full item URL. Used by the productDetails operation. Defaults to a demo product if left blank.", "default": "1005005452938708" }, "productIds": { "title": "Product IDs or item URLs - batch (optional)", "type": "array", "description": "Many product IDs or item URLs in one run. Wins over \"productId\" when filled.", "items": { "type": "string" } }, "maxItems": { "title": "Max items (optional)", "minimum": 1, "type": "integer", "description": "Caps total rows returned across the whole run (applies to search; productDetails always returns one row per product ID). The first 10 rows of any run are free. Leave blank for no cap - the search operation then follows AliExpress's own reported result count for the query." }, "proxyConfiguration": { "title": "Proxy configuration (optional)", "type": "object", "description": "Leave blank to let the Actor pick automatically: a US-pinned residential proxy for search (keeps pricing in USD - AliExpress geo-detects the IP and returns local-currency pricing otherwise), or a country-unpinned residential proxy for productDetails (root-caused 2026-08-25: pinning that operation to US instead reliably redirects it to aliexpress.us, a separate regional gateway with its own unsolved bot-challenge, on top of that page's already-slow client-side render - see the README's Limitations section). Only set this yourself to override that per-operation default." } } }, "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 } } }, "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 } } } } } } } } } }