{ "openapi": "3.0.1", "info": { "title": "AliExpress Product Details Scraper", "description": "Full AliExpress product data from URLs, IDs or keywords: every variant with price and stock, ratings, sales, shipping options, specs and seller stats. No login.", "version": "0.1", "x-build-id": "vTRv7TLd5j1KOg0tf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/magic-scraper~aliexpress-product-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-magic-scraper-aliexpress-product-details-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/magic-scraper~aliexpress-product-details-scraper/runs": { "post": { "operationId": "runs-sync-magic-scraper-aliexpress-product-details-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/magic-scraper~aliexpress-product-details-scraper/run-sync": { "post": { "operationId": "run-sync-magic-scraper-aliexpress-product-details-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": { "productUrls": { "title": "🔗 Product URLs", "type": "array", "description": "AliExpress product pages, e.g. https://www.aliexpress.com/item/1005006639944031.html. .com, .us and regional domains, app share links (a.aliexpress.com/_...) and affiliate links work.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "productIds": { "title": "🆔 Product IDs", "type": "array", "description": "Bare product IDs, one per line (e.g. 1005006639944031). Combined with the URLs above; duplicates are scraped and billed once.", "items": { "type": "string" } }, "searchKeywords": { "title": "🔍 Search Keywords (optional)", "type": "array", "description": "Find products by keyword on AliExpress search and scrape their full details (e.g. 'wireless earbuds').", "items": { "type": "string" } }, "maxProductsPerKeyword": { "title": "🔢 Max Products per Keyword", "minimum": 1, "maximum": 600, "type": "integer", "description": "How many search results per keyword to scrape in detail (search order, 60 per page).", "default": 20 }, "maxItems": { "title": "💯 Max Products", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many products are saved. Protects your budget.", "default": 50 }, "shipTo": { "title": "🌍 Ship-to Country", "type": "string", "description": "Two-letter country code: prices, stock, warehouse and shipping options are returned for this country (US, GB, DE, FR, PL, BR, ...). Titles stay in English. Products not sold to the country are skipped and not charged (US-only listings with IDs starting 3256 are usually not available elsewhere).", "default": "US" }, "currency": { "title": "💵 Currency", "type": "string", "description": "Three-letter currency code for all prices (USD, EUR, GBP, ...).", "default": "USD" }, "maxConcurrency": { "title": "⚡ Parallel Sessions", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many proxy sessions fetch products in parallel. AliExpress serves only a few products per IP, so the Actor keeps switching IPs. 25 is the measured sweet spot at the default 1 GB memory; going higher was not faster in tests and needs more memory.", "default": 25 }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "The first products use the run's own IP; after AliExpress limits it the Actor rotates Apify residential proxy sessions (DE, AU, CA, IT and ES IPs by default, where AliExpress blocks least; prices and shipping still follow Ship-to and Currency, not the IP country). Datacenter proxies are blocked by AliExpress. Turn the proxy off to scrape only ~9 products per run.", "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 } } } } } } } } } }