{
"openapi": "3.0.1",
"info": {
"title": "Lazada Scraper — Search, Product Data, Prices & Reviews",
"description": "Scrape Lazada data from all six Southeast Asian marketplaces: search results, full product pages and reviews. Price, discount, rating, sold count, seller, image gallery and every variant with its own price and stock, plus reviews with photos and seller replies. No login, no API key, no start fee.",
"version": "0.1",
"x-build-id": "9hAQJ2FFKZU81toqu"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/lergassy~lazada-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-lergassy-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/lergassy~lazada-scraper/runs": {
"post": {
"operationId": "runs-sync-lergassy-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/lergassy~lazada-scraper/run-sync": {
"post": {
"operationId": "run-sync-lergassy-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": {
"mode": {
"title": "🧭 What to scrape",
"enum": [
"auto",
"search",
"product",
"reviews",
"product_reviews"
],
"type": "string",
"description": "What to scrape. **Auto** runs search for keywords and search/category/shop URLs, and product details for product URLs. 🔍 Search returns product cards; 📦 Product details and ⭐ Reviews need product URLs.",
"default": "auto"
},
"country": {
"title": "🌎 Country / marketplace",
"enum": [
"ID",
"MY",
"SG",
"PH",
"TH",
"VN"
],
"type": "string",
"description": "Lazada marketplace for keyword searches. URLs keep their own country.",
"default": "ID"
},
"searchTerms": {
"title": "🔍 Search keywords",
"type": "array",
"description": "Keywords to search on the chosen marketplace, e.g. `wireless earbuds`. Each keyword returns product cards with price, discount, rating, sold count and seller, up to 🔢 Max products.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "🔗 Lazada URLs",
"type": "array",
"description": "Any Lazada links: product pages (.../products/...-i123456.html), search results, category, brand or shop pages. Bare item IDs also work. Product page URLs (`.../products/pdp-i.html`) are the reliable input right now.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "💯 Max products",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Stop after this many products per keyword or listing URL.",
"default": 40
},
"enrichProducts": {
"title": "Fetch full product details for every result ($)",
"type": "boolean",
"description": "Open each product page for description, image gallery, variants, highlights and brand. Slower and billed per product detail. On by default: the full product record is what this Actor is for.",
"default": true
},
"includeSpecifications": {
"title": "Full specifications (on by default)",
"type": "boolean",
"description": "The specification table, every variant's name, price and availability, delivery options with fees, warranty and return policy. Lazada shows them only inside its web app, so the Actor reads them through a real browser session in the storefront's country; billed as a separate event, only when they arrive. On by default; turn it off for cheaper, faster runs when the spec sheet is not what you came for.",
"default": true
},
"maxReviewsPerProduct": {
"title": "⭐ Max reviews per product",
"minimum": 1,
"maximum": 50000,
"type": "integer",
"description": "Reviews mode: how many reviews to collect for each product.",
"default": 100
},
"reviewsRating": {
"title": "⭐ Only reviews with rating",
"enum": [
"all",
"5",
"4",
"3",
"2",
"1"
],
"type": "string",
"description": "Reviews mode: keep only reviews with this star rating.",
"default": "all"
},
"sortBy": {
"title": "Sort results",
"enum": [
"relevance",
"price_asc",
"price_desc",
"newest",
"rating"
],
"type": "string",
"description": "Order of search results.",
"default": "relevance"
},
"minPrice": {
"title": "Min price",
"minimum": 0,
"type": "integer",
"description": "Minimum price in the marketplace's own currency."
},
"maxPrice": {
"title": "Max price",
"minimum": 0,
"type": "integer",
"description": "Maximum price in the marketplace's own currency."
},
"minRating": {
"title": "⭐ Minimum rating",
"minimum": 0,
"maximum": 5,
"type": "number",
"description": "Keep only products rated at least this (0–5 stars). Applied to the rating shown on the card; products without a rating are dropped when this is set."
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Lazada answers most automated requests with an anti-bot page. The Actor rotates by itself — platform egress, datacenter, then residential — and keeps the address that got through. Leave as is unless you have your own proxy URLs.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}