{ "openapi": "3.0.1", "info": { "title": "AliExpress Search Scraper – Products, Prices, Orders & Ratings", "description": "Scrape AliExpress search results by keyword: price and discount, items sold, rating, listing date, ships-from country, free shipping, Choice and deal badges. Any ship-to country and currency. No login. $0.0025/product.", "version": "1.0", "x-build-id": "G9hdsQNR45apjZwpC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tubetext~aliexpress-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tubetext-aliexpress-search-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/tubetext~aliexpress-search-scraper/runs": { "post": { "operationId": "runs-sync-tubetext-aliexpress-search-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/tubetext~aliexpress-search-scraper/run-sync": { "post": { "operationId": "run-sync-tubetext-aliexpress-search-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": [ "keywords" ], "properties": { "keywords": { "title": "Search keywords", "type": "array", "description": "One search per line, e.g. 'yoga mat', 'phone case', 'led strip lights'.", "items": { "type": "string" } }, "maxItemsPerKeyword": { "title": "Max products per keyword", "minimum": 1, "maximum": 1200, "type": "integer", "description": "AliExpress shows 60 products per page (up to 20 pages).", "default": 60 }, "sortBy": { "title": "Sort by", "enum": [ "best_match", "orders", "price_asc", "price_desc" ], "type": "string", "description": "Result order on AliExpress.", "default": "best_match" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Optional, in the selected currency." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Optional, in the selected currency." }, "shipTo": { "title": "Ship to country", "enum": [ "US", "GB", "DE", "FR", "ES", "IT", "NL", "PL", "BE", "SE", "CA", "AU", "BR", "MX", "KR", "JP", "IL", "SA", "AE", "TR", "CL" ], "type": "string", "description": "Prices, shipping and local warehouses depend on the destination.", "default": "US" }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "CAD", "AUD", "BRL", "MXN", "KRW", "JPY", "PLN", "SEK", "ILS", "SAR", "AED", "TRY", "CLP" ], "type": "string", "description": "Currency for prices.", "default": "USD" }, "skipSponsored": { "title": "Skip sponsored products", "type": "boolean", "description": "Ads are mixed into AliExpress results (about 1 in 4). Turn on to keep organic results only.", "default": false }, "skipNewShopperDeals": { "title": "Skip new-shopper deal prices", "type": "boolean", "description": "Many search prices are one-time welcome deals for new AliExpress customers (\"New shoppers save…\"), which regular buyers don't get. Turn on to leave those products out, e.g. for supplier price comparisons. Each row also has priceIsNewShopperDeal.", "default": false }, "maxConcurrency": { "title": "Keywords in parallel", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many keywords are searched at the same time.", "default": 3 } } }, "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 } } } } } } } } } }