{ "openapi": "3.0.1", "info": { "title": "AliExpress Bulk Scraper Pro", "description": "Collect public AliExpress product details from keyword searches or public item URLs, with product records in the dataset and a separate run summary.", "version": "1.2", "x-build-id": "YTx5TKNzpQCu0ceMR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codingfrontend~aliexpress-bulk-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codingfrontend-aliexpress-bulk-scraper-pro", "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/codingfrontend~aliexpress-bulk-scraper-pro/runs": { "post": { "operationId": "runs-sync-codingfrontend-aliexpress-bulk-scraper-pro", "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/codingfrontend~aliexpress-bulk-scraper-pro/run-sync": { "post": { "operationId": "run-sync-codingfrontend-aliexpress-bulk-scraper-pro", "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": { "queries": { "title": "Search queries", "maxItems": 50, "type": "array", "description": "Search phrases used to build public AliExpress product search pages. Supply up to 50 phrases; an empty list uses the default search only when productUrls is also empty.", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "default": [] }, "itemLimit": { "title": "Maximum products", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of unique product records across all direct item URLs and search phrases.", "default": 10 }, "productUrls": { "title": "Product URLs", "maxItems": 100, "type": "array", "description": "Public AliExpress item pages to inspect directly. Provide up to 100 HTTPS item URLs on an approved AliExpress host, without query parameters or fragments. These are processed before searches and share the overall item limit.", "items": { "type": "object", "additionalProperties": false, "properties": { "url": { "title": "AliExpress item URL", "type": "string", "description": "A public AliExpress item URL with an 8–30 digit item ID, such as https://www.aliexpress.com/item/1005001234567890.html.", "maxLength": 2048, "pattern": "^https://(?:www\\.aliexpress\\.com|aliexpress\\.com|m\\.aliexpress\\.com|www\\.aliexpress\\.us|m\\.aliexpress\\.us|www\\.aliexpress\\.co\\.uk|www\\.aliexpress\\.de|www\\.aliexpress\\.fr|www\\.aliexpress\\.es|www\\.aliexpress\\.it|www\\.aliexpress\\.nl|www\\.aliexpress\\.pl|www\\.aliexpress\\.ru)/item/\\d{8,30}\\.html$" } }, "required": [ "url" ] }, "default": [] }, "timeoutMs": { "title": "Request timeout (milliseconds)", "minimum": 5000, "maximum": 120000, "type": "integer", "description": "Maximum time for each public search page, item page, or robots.txt request.", "default": 30000 }, "maxResponseBytes": { "title": "Maximum response size (bytes)", "minimum": 1000, "maximum": 15000000, "type": "integer", "description": "Maximum response body size accepted for each public request.", "default": 5000000 }, "useBrowser": { "title": "Use ordinary browser rendering", "type": "boolean", "description": "Render public pages with a standard browser when enabled. It does not log in, solve CAPTCHA challenges, or bypass access controls.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional account-enabled Apify Proxy settings for public requests. Proxy use is off by default and depends on your account access.", "default": { "useApifyProxy": 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 } } } } } } } } } }