{ "openapi": "3.0.1", "info": { "title": "Lazada Scraper — Products, Prices & Reviews (SEA)", "description": "Scrape Lazada products from search, category and product URLs in Singapore, Malaysia, Thailand, Philippines, Indonesia and Vietnam: price, discount, rating, sold, seller, reviews.", "version": "0.1", "x-build-id": "Js6M61XMVbJCbSY4n" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tortuga~lazada-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tortuga-lazada-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/tortuga~lazada-scraper/runs": { "post": { "operationId": "runs-sync-tortuga-lazada-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/tortuga~lazada-scraper/run-sync": { "post": { "operationId": "run-sync-tortuga-lazada-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search on the Lazada site chosen in Country, one per line (e.g. \"wireless earbuds\", \"rice cooker\"). Each term is searched separately and paginated automatically (40 products per page).", "items": { "type": "string" } }, "country": { "title": "Country (for search terms)", "enum": [ "SG", "MY", "TH", "PH", "ID", "VN" ], "type": "string", "description": "Which Lazada site the search terms run on. Start URLs always use the site in their own address.", "default": "SG" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Lazada URLs from any of the six sites, instead of (or in addition to) search terms: search pages (https://www.lazada.sg/catalog/?q=power+bank), category pages (https://www.lazada.com.my/shop-mobiles/), brand or store product lists, with any filters you set on the site (price, rating, location), or single product pages (https://www.lazada.co.th/products/...-i123456789.html, returned with full details).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max products", "minimum": 1, "type": "integer", "description": "Stop after this many products in total (across all search terms and URLs). Keeps cost predictable.", "default": 100 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 102, "type": "integer", "description": "How many result pages to open per search term or listing URL (40 products each). Lazada serves at most 102 pages (4,080 products) per listing.", "default": 10 }, "sortBy": { "title": "Sort by", "enum": [ "popularity", "priceasc", "pricedesc" ], "type": "string", "description": "Result order for search terms and listing URLs: best match (Lazada's default) or price low to high / high to low. Lazada offers no other sort.", "default": "popularity" }, "includeDetails": { "title": "Include product details", "type": "boolean", "description": "Also open every product's page to get the full description text and images, category path, the complete image gallery, video, every variant (options such as color / size with their SKU id, image and URL) and stock status. Charged extra per product (see pricing). Product URLs always include details.", "default": false }, "maxReviewsPerProduct": { "title": "Reviews per product", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Number of customer reviews to add to every product (0 = none): rating, text, date, reviewer name as shown, purchased variant, photos, video and seller reply, plus the star distribution. Reviews come in Lazada's default order. Charged per review (see pricing).", "default": 0 }, "onlyNewOrChanged": { "title": "Only new or changed items", "type": "boolean", "description": "Remember what earlier runs of this search returned and output only new items or items whose price/status changed. Use with a Schedule; unchanged items are not charged. Compared: price, struck-through original price and stock; sold counts, ratings and review counts are ignored. With this on, Max products is the number of products checked each run (the watched window, e.g. the first 40 results), and details / reviews are fetched only for new or changed products.", "default": false }, "monitoringKey": { "title": "Monitoring key", "type": "string", "description": "Name for this watch, so several schedules on the same search stay separate; defaults to a key derived from the search input." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Keep the default Apify Unblocker proxy: Lazada blocks its product-list data for datacenter and residential IPs. Each successful Unblocker request costs about $0.0015 in proxy usage (10 units) and returns 40 products, so about $0.04 per 1,000 products. With this default, product pages and reviews go through cheaper residential IPs of the product's own country (falling back to the Unblocker). A different proxy is used as given for everything.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } } } }, "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 } } } } } } } } } }