{ "openapi": "3.0.1", "info": { "title": "AliExpress Product Scraper - Search, Details & Price Tracker", "description": "AliExpress products from keywords, category URLs, product URLs or IDs. Price, discount, rating, sold count, store, shipping and SKU variants for your ship-to country and currency. Price-change alerts between runs. No login. Failed inputs are free.", "version": "0.1", "x-build-id": "juhMj2xehYEBUa2Uf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dottti~aliexpress-products/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dottti-aliexpress-products", "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/dottti~aliexpress-products/runs": { "post": { "operationId": "runs-sync-dottti-aliexpress-products", "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/dottti~aliexpress-products/run-sync": { "post": { "operationId": "run-sync-dottti-aliexpress-products", "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": { "searchKeywords": { "title": "Search keywords", "type": "array", "description": "Words to search on AliExpress, one per line, for example wireless earbuds. Each keyword returns up to Maximum products per input.", "items": { "type": "string" } }, "startUrls": { "title": "Search, category or product URLs", "type": "array", "description": "AliExpress addresses: search result pages (/w/wholesale-...), category pages (/category/123/name.html) or product pages (/item/1005....html).", "items": { "type": "string" } }, "productIds": { "title": "Product IDs", "type": "array", "description": "Bare AliExpress product IDs, one per line, for example 1005009569678787. Product IDs and product URLs always return full details.", "items": { "type": "string" } }, "includeDetails": { "title": "Add full details to search results", "type": "boolean", "description": "Open each search result's product data to add store name and rating, shipping fee and delivery days, and SKU variants. Slower, billed at the details price. Off: search results come from the result page only.", "default": false }, "shipTo": { "title": "Ship-to country", "type": "string", "description": "Two-letter country code. Prices, availability and shipping are shown for this country, for example US, SA, AE, DE.", "default": "US" }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter currency code for all prices, for example USD, SAR, AED, EUR.", "default": "USD" }, "language": { "title": "Language", "type": "string", "description": "Language of titles and labels, as AliExpress names it, for example en_US, ar_MA, fr_FR, de_DE.", "default": "en_US" }, "sort": { "title": "Sort search results", "enum": [ "default", "orders", "price_asc", "price_desc" ], "type": "string", "description": "Order of search and category results.", "default": "default" }, "maxItems": { "title": "Maximum products per input", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many products for each keyword or URL. A search page holds up to 60 products.", "default": 20 }, "onlyChanged": { "title": "Only new products and price changes", "type": "boolean", "description": "Compare with the previous run and return only products that are new or whose price moved. Each row gets changeType, previousPrice and priceChange. The first run returns everything as the baseline.", "default": false }, "stateName": { "title": "Tracking list name", "type": "string", "description": "Names the saved price history. Use one name per watchlist so separate schedules do not overwrite each other.", "default": "default" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave empty for automatic: no proxy first, then Apify datacenter, then residential only if AliExpress refuses. Set your own proxy here to use only that." }, "autoProxyFallback": { "title": "Automatic proxy fallback", "type": "boolean", "description": "Move to a proxy when AliExpress refuses requests.", "default": true }, "allowResidentialFallback": { "title": "Allow residential proxy", "type": "boolean", "description": "Allow the last proxy step. Product details usually need it after the first few products.", "default": true }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Pause between requests. Raise it if the run summary shows many captcha answers.", "default": 1500 }, "maxRetries": { "title": "Retries per request", "minimum": 1, "maximum": 8, "type": "integer", "description": "Retries with backoff and a fresh proxy session after a refusal.", "default": 4 } } }, "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 } } } } } } } } } }