{ "openapi": "3.0.1", "info": { "title": "AliExpress Product Details Scraper: SKUs & Stock", "description": "Get full AliExpress product details from product links: prices, every variant with its stock, shipping, specifications, photos and seller. Pay only for products that come back with data.", "version": "0.1", "x-build-id": "eTp0CXIYc2NuhSwIQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapelark~aliexpress-product-details/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapelark-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/scrapelark~aliexpress-product-details/runs": { "post": { "operationId": "runs-sync-scrapelark-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/scrapelark~aliexpress-product-details/run-sync": { "post": { "operationId": "run-sync-scrapelark-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": [ "productUrls" ], "properties": { "productUrls": { "title": "Product links", "type": "array", "description": "Full AliExpress product links, for example https://www.aliexpress.com/item/32848744075.html. Links from aliexpress.us, other country sites and the mobile site work too. For a long list, use \"Upload file\" or \"Link remote text file\": a text file with one product link or product ID per line. The same product listed twice is read once.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "shipTo": { "title": "Ship to country", "enum": [ "AU", "AT", "BE", "BR", "CA", "CL", "CO", "CZ", "DK", "FI", "FR", "DE", "GR", "HU", "IE", "IL", "IT", "JP", "MX", "NL", "NZ", "NO", "PE", "PL", "PT", "RO", "SA", "SG", "SK", "ZA", "KR", "ES", "SE", "CH", "TR", "UA", "AE", "GB", "US" ], "type": "string", "description": "Prices, availability and shipping options are for this country. Each run uses one country; run again for another.", "default": "US" }, "currency": { "title": "Currency", "enum": [ "AUD", "BRL", "GBP", "CAD", "CLP", "COP", "CZK", "DKK", "EUR", "HUF", "ILS", "JPY", "MXN", "NZD", "NOK", "PEN", "PLN", "RON", "SAR", "SGD", "ZAR", "KRW", "SEK", "CHF", "TRY", "AED", "UAH", "USD" ], "type": "string", "description": "The currency for all prices. If AliExpress does not show prices in this currency for the chosen country, each row's currency field says which one it used.", "default": "USD" }, "maxItems": { "title": "Max products", "minimum": 1, "type": "integer", "description": "The run reads at most this many products from the list, in the order given.", "default": 50 }, "recheckKnownUnavailable": { "title": "Check known unavailable products again", "type": "boolean", "description": "The actor keeps a short list in your own Apify account of products that were not found (kept 30 days) or not sold to the ship-to country (kept 3 days). A later run gives those products their free row at once, with the date of the real check in checkedAt, and does not open their pages. Turn this on to open every product page again.", "default": false } } }, "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 } } } } } } } } } }