{ "openapi": "3.0.1", "info": { "title": "AliExpress Products Scraper", "description": "Search AliExpress by keyword, search or category link. Get price, discount, rating, exact sold count, sales per day, estimated revenue, shipping and delivery for every product as clean JSON. Find trending products. Bulk input, no account or cookies needed.", "version": "1.0", "x-build-id": "bjSBGtkVny6Db3N5t" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/insights_data~aliexpress-products-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-insights_data-aliexpress-products-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/insights_data~aliexpress-products-scraper/runs": { "post": { "operationId": "runs-sync-insights_data-aliexpress-products-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/insights_data~aliexpress-products-scraper/run-sync": { "post": { "operationId": "run-sync-insights_data-aliexpress-products-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": [ "urls" ], "properties": { "urls": { "title": "🔎 Search keywords or AliExpress links", "minItems": 1, "type": "array", "description": "Keywords to search for (for example wireless earbuds) or AliExpress search and category links, one per line. Bulk lists are welcome. Product, store and home page links are not supported.", "items": { "type": "string" } }, "maxProducts": { "title": "🔢 Max products per search", "minimum": 1, "maximum": 360000, "type": "integer", "description": "Stop each search after this many products. One search can return up to about 3,600 products.", "default": 10 }, "sortBy": { "title": "📊 Sort by", "enum": [ "default", "price_asc", "price_desc", "orders" ], "type": "string", "description": "Order of the search results.", "default": "default" }, "country": { "title": "🌍 Country", "enum": [ "US", "GB", "DE", "FR", "ES", "IT", "NL", "PL", "PT", "BR", "RU", "MX", "CA", "AU", "NZ", "SA", "AE", "IL", "TR", "IN", "JP", "KR", "SG", "MY", "TH", "ID", "PH", "VN", "ZA", "EG", "UA", "KZ" ], "type": "string", "description": "Shopper country. It sets the currency of the prices and the shipping offers shown.", "default": "US" }, "freeShipping": { "title": "🚚 Free shipping only", "type": "boolean", "description": "Keep only products whose listing shows plain free shipping.", "default": false }, "choiceOnly": { "title": "🏅 Choice products only", "type": "boolean", "description": "Keep only products with the AliExpress Choice badge.", "default": false }, "minRating": { "title": "🌟 Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep only products with at least this star rating (0 to 5). 0 means no rating filter.", "default": 0 }, "minSold": { "title": "🔥 Minimum units sold", "minimum": 0, "type": "integer", "description": "Keep only products sold at least this many times. 0 means no filter.", "default": 0 }, "minPrice": { "title": "💵 Minimum price", "minimum": 0, "type": "number", "description": "Keep only products priced at or above this amount, in the currency of the selected country. 0 means no minimum.", "default": 0 }, "maxPrice": { "title": "💰 Maximum price", "minimum": 0, "type": "number", "description": "Keep only products priced at or below this amount, in the currency of the selected country. 0 means no maximum.", "default": 0 }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Runs start without a proxy. If the requests are rejected, the Actor switches to stronger proxies on its own and keeps using them for the rest of the run. Choose Apify Proxy here only if you want to start with a proxy.", "default": { "useApifyProxy": 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 } } } } } } } } } }