{ "openapi": "3.0.1", "info": { "title": "AliExpress Scraper β€” Search, SKU Prices & Reviews", "description": "Scrape AliExpress search results, SKU price matrices, buyer reviews, shipping costs per country and store catalogs by item ID, seller ID or keyword. Built for dropshipping research, AliExpress price tracking and supplier vetting. Pay per result from $0.002, no browser, no login.", "version": "1.0", "x-build-id": "jHlgEwEwSiTeEihwC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~aliexpress-product-details/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-aliexpress-product-details", "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/sian.agency~aliexpress-product-details/runs": { "post": { "operationId": "runs-sync-sian.agency-aliexpress-product-details", "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/sian.agency~aliexpress-product-details/run-sync": { "post": { "operationId": "run-sync-sian.agency-aliexpress-product-details", "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": [ "searchProducts", "skuPrices", "productReviews", "shippingEstimate", "storeProducts" ], "type": "string", "description": "πŸ” One operation per run:\n\n- **Search Products**: keyword search, 20 products per page\n- **SKU Prices**: every variant with price, promo and stock\n- **Product Reviews**: buyer reviews with star and photo filters\n- **Shipping Estimate**: carriers, fees and delivery dates\n- **Store Products**: a store's catalog\n\nπŸ’‘ Search first, then reuse `itemId`.", "default": "searchProducts" }, "keyword": { "title": "πŸ”Ž Search Keyword", "type": "string", "description": "πŸ”Ž **Required for Search Products.** What you would type into the AliExpress search bar, e.g. `bluetooth earbuds`.\n\nAbout 20 products per page, each with title, price, sale price, units sold, rating and image." }, "itemId": { "title": "πŸ†” Product Item ID", "type": "string", "description": "πŸ†” **Required for SKU Prices, Product Reviews and Shipping Estimate.** An AliExpress product ID or the full product URL.\n\n- From a URL: `https://www.aliexpress.com/item/3256812550576374.html` β†’ `3256812550576374`\n- From a Search Products row: the `itemId` field" }, "sellerId": { "title": "πŸ‘€ Seller ID", "pattern": "^\\d+$", "type": "string", "description": "πŸ‘€ **Required for Store Products.** The numeric seller ID β€” the `sellerId` field of a SKU Prices row." }, "storeId": { "title": "πŸͺ Store ID", "pattern": "^\\d+$", "type": "string", "description": "πŸͺ **Required for Store Products, together with Seller ID.** The number in the store's URL (`aliexpress.com/store/1104026059` β†’ `1104026059`). It must be that seller's store: any other pairing can return a different store's catalog." }, "maxPages": { "title": "πŸ“„ Max Pages", "minimum": 1, "maximum": 50, "type": "integer", "description": "πŸ“„ **Search Products, Product Reviews, Store Products.** Pages to fetch, 20 rows per page, up to 50. Other operations ignore it.\n\nπŸ†“ Free Apify plans get 25 rows per run.", "default": 5 }, "sort": { "title": "↕️ Sort Order", "enum": [ "default", "salesDesc", "priceAsc", "priceDesc" ], "type": "string", "description": "↕️ **Search Products and Store Products.** Order of the listing.", "default": "default" }, "minPrice": { "title": "πŸ’΅ Min Price", "minimum": 0, "type": "number", "description": "πŸ’΅ **Search Products.** Lowest price to include, in the currency you pick below." }, "maxPrice": { "title": "πŸ’Ž Max Price", "minimum": 0, "type": "number", "description": "πŸ’Ž **Search Products.** Highest price to include, in the currency you pick below." }, "currency": { "title": "πŸ’± Currency", "enum": [ "USD", "EUR", "GBP", "CAD", "AUD", "BRL", "MXN", "PLN", "TRY", "JPY", "KRW" ], "type": "string", "description": "πŸ’± Currency for every price in the results.", "default": "USD" }, "shipFromRegion": { "title": "πŸ—ΊοΈ Market", "enum": [ "US", "UK", "DE", "FR", "ES", "IT", "NL", "BE", "AT", "CH", "PT", "IE", "PL", "CZ", "SE", "UA", "TR", "IL", "SA", "AE", "CA", "MX", "BR", "CL", "AU", "NZ", "JP", "KR" ], "type": "string", "description": "πŸ—ΊοΈ The AliExpress market to read prices and availability from (Search, SKU Prices, Reviews, Store Products).", "default": "US" }, "reviewFilter": { "title": "⭐ Review Filter", "enum": [ "allReviews", "hasImage", "hasAdditional", "isLocal", "fiveStar", "fourStar", "threeStar", "twoStar", "oneStar" ], "type": "string", "description": "⭐ **Product Reviews.** Which reviews to return: all, with photos, with follow-up feedback, from buyers in your region, or one star rating.", "default": "allReviews" }, "reviewSort": { "title": "πŸ“… Review Sort", "enum": [ "default", "latest" ], "type": "string", "description": "πŸ“… **Product Reviews.** Default order or newest first.", "default": "default" }, "shipToCountry": { "title": "🌍 Ship-to Country", "enum": [ "US", "UK", "DE", "FR", "ES", "IT", "NL", "BE", "AT", "CH", "PT", "IE", "PL", "CZ", "SE", "UA", "TR", "IL", "SA", "AE", "CA", "MX", "BR", "CL", "AU", "NZ", "JP", "KR" ], "type": "string", "description": "🌍 **Shipping Estimate.** Destination country for the shipping quote.", "default": "US" }, "quantity": { "title": "πŸ“¦ Quantity", "minimum": 1, "maximum": 999, "type": "integer", "description": "πŸ“¦ **Shipping Estimate.** How many units to quote shipping for.", "default": 1 } } }, "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 } } } } } } } } } }