{ "openapi": "3.0.1", "info": { "title": "AliExpress Scraper - Products, Prices, Orders Sold & Ratings", "description": "Scrape AliExpress search results by keyword or URL: price, original price, discount, units sold, rating, ship-from, free shipping, Choice and best-seller badges, attributes, images. Any ship-to country and currency. Monitor mode: only new products and price changes. No login.", "version": "0.1", "x-build-id": "kMh6OsK7CpuBEXJhZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/get_anything~aliexpress-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-get_anything-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/get_anything~aliexpress-scraper/runs": { "post": { "operationId": "runs-sync-get_anything-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/get_anything~aliexpress-scraper/run-sync": { "post": { "operationId": "run-sync-get_anything-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": { "searchKeywords": { "title": "Search keywords", "type": "array", "description": "What to search on AliExpress, one per line. Any language works ('wireless earbuds', '蓝牙耳机', 'funda iphone').", "items": { "type": "string" } }, "searchUrls": { "title": "AliExpress search URLs", "type": "array", "description": "Optional. Paste AliExpress search result URLs (aliexpress.com/w/wholesale-...) to keep the filters you set on the site. Sort and price inputs below are ignored for these.", "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max products per search", "minimum": 0, "maximum": 3600, "type": "integer", "description": "How many products to return per keyword or URL. AliExpress shows 60 per page and up to 3,600 per search. 0 = all.", "default": 60 }, "sortBy": { "title": "Sort by", "enum": [ "best-match", "orders", "price-low", "price-high" ], "type": "string", "description": "Order of results for keyword searches.", "default": "best-match" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Optional. Only products at or above this price (in the chosen currency)." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Optional. Only products at or below this price (in the chosen currency)." }, "shipToCountry": { "title": "Ship-to country", "type": "string", "description": "Two-letter country code that prices, shipping and availability follow (US, GB, DE, FR, SG, AE, SA, AU, CA, BR...). Note: AliExpress shows very few products for India (IN).", "default": "US" }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter currency code for prices (USD, EUR, GBP, SGD, AED, CNY, BRL...).", "default": "USD" }, "onlyChanges": { "title": "Monitor mode: only new products & price changes", "type": "boolean", "description": "Remember each search's products and return only products that are new or whose price went up or down since the last run (with previousPrice). The first run returns everything as 'new'. Schedule it daily for price tracking.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy keeps runs reliable: if AliExpress shows its slider check, the page is retried from a fresh IP. The default datacenter proxy works well.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }