{ "openapi": "3.0.1", "info": { "title": "AliExpress Product Details Scraper — Variants, Stock, Shipping", "description": "Paste AliExpress product links or IDs and get every variant with its own price and stock, shipping options and delivery dates for your country, seller rating and age, specs, images, video and the description link. Unavailable products are flagged and never charged.", "version": "0.0", "x-build-id": "X2cZEpb3gHbjLIYJX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~aliexpress-product-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~aliexpress-product-details-scraper/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~aliexpress-product-details-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-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", "required": [ "productUrls" ], "properties": { "productUrls": { "title": "Products (links or IDs)", "type": "array", "description": "One product per line: a link from any AliExpress site (www, .us, .ru, de., fr., m. mobile pages, app links, a.aliexpress.com/_… share links) or just the number from /item/.html. A block pasted with commas works too, and a product listed twice is fetched once. aliexpress.ru links whose ID starts with 1_ (like /item/1_542628186.html) are AliExpress Russia's own listings and cannot be read.", "items": { "type": "string" } }, "maxItems": { "title": "Products to take from the list", "minimum": 1, "type": "integer", "description": "The run works down the list from the top and stops after this many, default 50. Products that turn out unavailable count toward it but are not charged. The run also stops early at your spending limit, and on the free Apify plan it takes 20.", "default": 50 }, "currency": { "title": "Show prices in", "enum": [ "USD", "EUR", "GBP", "CAD", "AUD", "BRL", "MXN", "PLN", "SEK", "KRW", "JPY", "TRY", "ILS", "SAR", "AED", "CLP", "UAH", "CHF", "RUB", "INR", "NOK", "DKK", "CZK", "HUF", "RON", "NZD", "SGD", "KZT", "COP", "PEN", "ARS" ], "type": "string", "description": "Every price in a row, from variant prices to shipping fees, comes back in this currency as AliExpress quotes it.", "default": "USD" }, "shipTo": { "title": "Delivery country", "enum": [ "US", "AR", "AM", "AU", "AT", "AZ", "BY", "BE", "BA", "BR", "BG", "CA", "CL", "CO", "HR", "CZ", "EE", "FR", "GE", "DE", "GR", "HU", "IN", "IL", "IT", "JP", "KZ", "KG", "LV", "LT", "MX", "MD", "MN", "NL", "NZ", "PE", "PL", "PT", "RO", "RU", "SA", "RS", "SG", "SK", "KR", "ES", "SE", "CH", "TJ", "TR", "TM", "UA", "AE", "GB", "UZ" ], "type": "string", "description": "AliExpress quotes shipping methods, fees, delivery dates and availability for one destination. shipsToCountry is false on products that do not ship there. For several countries, run once per country.", "default": "US" }, "maxConcurrency": { "title": "Products fetched at once", "minimum": 1, "maximum": 10, "type": "integer", "description": "1 to 10, default 4. Higher numbers finish long lists sooner.", "default": 4 }, "proxyConfiguration": { "title": "Your own proxy (optional)", "type": "object", "description": "Leave empty: the actor brings its own connections. Fill in only to route requests through your own proxy URLs." } } }, "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 } } } } } } } } } }