{ "openapi": "3.0.1", "info": { "title": "Lazada Product & Review Scraper - 6 Country Sites by URL", "description": "Give it Lazada product URLs and get the public product and its reviews back, on all six Lazada country sites. No login and no cookies.", "version": "0.0", "x-build-id": "d5yFNQ5atZBFDlsAW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lanternlab318~lazada/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lanternlab318-lazada", "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/lanternlab318~lazada/runs": { "post": { "operationId": "runs-sync-lanternlab318-lazada", "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/lanternlab318~lazada/run-sync": { "post": { "operationId": "run-sync-lanternlab318-lazada", "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 URLs", "type": "array", "description": "One Lazada product URL per line, from any of the six country sites - for example https://www.lazada.com.my/products/...-i3718725294.html. A bare numeric item id also works and is then read on the country chosen below. The country site is taken from each URL, so URLs from different countries can be mixed in one run. A product listed twice is collected once.", "items": { "type": "string" } }, "country": { "title": "Country site", "enum": [ "MY", "SG", "TH", "PH", "VN", "ID" ], "type": "string", "description": "Which Lazada site a bare item id belongs to. Entries given as full URLs ignore this and use their own country. An item id is only valid on its own country site: the same number on another site is a different product or no product at all.", "default": "MY" }, "includeReviews": { "title": "Collect reviews", "type": "boolean", "description": "With this on, every product also gets one row per review: star rating, review text, review date, the SKU the reviewer bought and any review photos. Turn it off for a product-only run, which costs one request per product - the product's star rating and review count are returned either way.", "default": true }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Upper bound on the review rows one product may produce. Lazada serves 20 reviews per request, so this rounds up to whole pages. A product whose list is cut short by this setting is marked partial with reason \"review_limit_reached\", so a deliberate limit is never mistaken for a product running out of reviews.", "default": 100 }, "residentialFallback": { "title": "Retry a refused request from a residential IP", "type": "boolean", "description": "Lazada's Malaysian and Philippine sites answer the cheap datacenter proxy, while the Singapore, Thai and Vietnamese sites refuse it and answer only a residential exit in their own country. With this on, a refused request is retried once that way, and the sites known to refuse datacenter IPs start there. Turn it off for a strictly datacenter-only, cheapest run that reports those sites as blocked rather than paying for residential traffic.", "default": true }, "maxUpstreamRequests": { "title": "Max Lazada requests", "minimum": 1, "type": "integer", "description": "Hard ceiling on the HTTP requests this run sends to Lazada, counting every residential retry. At the ceiling collection stops - the products not reached are written with partialReason \"not_collected\" and the run then ends normally. Leave empty and the Actor works a ceiling out from your products and limits, so a run is never unbounded." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The proxy the requests to Lazada go through. The default (Apify Proxy, datacenter) is the cheapest and is what this Actor is measured on for Malaysia and the Philippines. The residential retry above is configured separately and always matches the product's country.", "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 } } } } } } } } } }