# Lazada Listings Scraper (`piotrv1001/lazada-listings-scraper`) Actor The Lazada Listings Scraper extracts product data from all six SEA storefronts (SG/MY/TH/PH/VN/ID), capturing titles, prices, discounts, sold counts, ratings, reviews, variants, sellers, and images — ideal for price monitoring, catalog research, and competitor intelligence. - **URL**: https://apify.com/piotrv1001/lazada-listings-scraper.md - **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 product listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### 🛒 Lazada Listings Scraper Easily extract product listings from Lazada across all six Southeast Asian storefronts (Singapore, Malaysia, Thailand, Philippines, Vietnam, Indonesia). The **Lazada Listings Scraper** delivers structured product data for price monitoring, catalog research, and competitor tracking — and reliably bypasses Alibaba's TMD anti-bot stack that blocks most other scrapers. ### ✨ Features - 🏷️ **Comprehensive Product Data**: Retrieve product titles, prices, original prices, discounts, currencies, sold counts, ratings, review counts, images, variants, sellers, brands, and category breadcrumbs. - 🌏 **Six SEA Storefronts**: One actor covers `lazada.sg`, `lazada.com.my`, `lazada.co.th`, `lazada.com.ph`, `lazada.vn`, and `lazada.co.id` — pick the country from a dropdown. - 🔍 **Multiple Discovery Modes**: Scrape by free-text search query, category slug (`/shop-mobiles/`), direct product URL, or grab the daily homepage flash sale. - 🛡️ **TMD Anti-Bot Bypass**: Survives Lazada's captcha gating via managed residential proxies — no browser, no Playwright, no fragile stealth scripts. - ⚡ **Fast & Efficient**: Search/category pages return ~40 products with full card data each at ~0.75 credits per product. PDP enrichment available when you need the full product object. ### 🛠️ How It Works 1. **Pick a country** — choose your Lazada storefront from the dropdown. 2. **Pick a discovery mode** — search queries, category slugs, explicit product URLs, or the homepage flash sale. 3. **Run the Scraper** — start the process and receive structured product data instantly into the dataset. 4. **Export** — download as JSON, JSONL, CSV, Excel, HTML, or XML, or pull via the Apify API. ### ⚙️ Input | Field | Type | Description | Default | | ----------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | | `country` | `string` | Lazada storefront. One of `sg`, `my`, `th`, `ph`, `vn`, `id`. Sets the domain, currency, and Scrapfly proxy country. | `sg` | | `startUrls` | `array` | Explicit Lazada URLs to scrape. Accepts product pages (`/products/...-iXXXXX.html`), search pages (`/catalog/?q=...`), and category pages. | `[]` | | `searchQueries` | `array` | Free-text keywords. Each query is paginated from `searchStartPage` to `searchEndPage`. | `[]` | | `categories` | `array` | Lazada category slugs (e.g. `mobiles`, `laptops`, `cameras`). Scraper hits `/shop-{slug}/`. | `[]` | | `homepageOnly` | `boolean` | Fast free mode — fetches only the country homepage and emits the daily flash-sale items. No Scrapfly credits used. | `false` | | `searchStartPage` | `integer` | First page index for search/category pagination. Defaults to **2** because Lazada serves a promo landing module on page 1 instead of a grid. | `2` | | `searchEndPage` | `integer` | Last page index (inclusive) for search/category pagination. | `5` | | `maxItems` | `integer` | Hard cap on the number of items pushed to the dataset. `0` means unlimited. | `50` | ### 💰 Pricing (Pay-Per-Event) This actor uses **Pay-Per-Event** billing — you only pay for the data classes you actually consume. Choose the input mode that matches your need; the cost per row is fixed by what we emit. | Event | When it fires | Price / 1k rows | Per row | | ----- | ------------- | --------------- | ------- | | `homepage-item` | Run with `homepageOnly: true` — daily flash-sale snapshot from the country homepage. | **$0.50** | $0.0005 | | `product-listing` | Each card parsed from a search (`/catalog/?q=...`) or category (`/shop-{slug}/`) result page. Carries title, voucher-applied price, discount %, sold count, rating, review count, and image. | **$3.00** | $0.003 | | `item-detail` | Each full product detail page from an explicit `startUrls` PDP. Adds description, brand, breadcrumbs, variants, seller, and full image gallery. | **$10.00** | $0.01 | **Practical cost examples:** - Watching today's flash-sale (~30 items): **~$0.015** - 200 products from a category sweep (5 pages × ~40 items): **~$0.60** - 1,000 full PDPs for a price-monitoring pipeline: **$10.00** **Tip:** Search/category mode already returns the voucher-applied price plus rating, reviews, and sold count. For most price-tracking use cases that's all you need — `item-detail` is only required if you want the full description, variants, or seller details. ### 📊 Sample Output Data The scraper provides structured JSON output with key product details. Example: ```json [ { "itemId": "3179771414", "skuId": "21628177316", "url": "https://www.lazada.sg/products/pdp-i3179771414.html", "countryCode": "sg", "title": "Google Pixel XL Original Unlocked 4GB RAM 32GB ROM Android 4G LTE Phone", "price": 118.84, "currency": "SGD", "discountPercent": 20, "soldCount": 5, "reviewCount": 1, "ratingAverage": 5, "images": [ "https://img.lazcdn.com/g/p/0091046bf97944f4218cd858f1c6c6a7.jpg_200x200q75.jpg" ], "source": "category", "scrapedAt": "2026-05-17T11:30:32.480Z" }, { "itemId": "100362025", "skuId": "16307225598", "url": "https://www.lazada.sg/products/pdp-i100362025-s16307225598.html", "countryCode": "sg", "title": "Superchia Organic Chia Seeds 500g USDA-certified(expiry 2028)", "brand": "SuperFarm", "breadcrumbs": ["Groceries", "Food Staples & Cooking Essentials", "Dried Goods"], "category": "Dried Goods", "categoryId": "10003344", "price": 18, "currency": "SGD", "images": [ "https://laz-img-sg.alicdn.com/p/ae6ce73aec2f3bd8ddda4bacd0577003.jpg", "https://laz-img-sg.alicdn.com/p/bc9c9a88db0a7ec21f8d532155b90b85.jpg" ], "variants": [ { "skuId": "100367035", "options": { "propPath": "120132602:2 packs (500gx2)" } } ], "seller": { "id": "1677" }, "source": "pdp", "scrapedAt": "2026-05-17T11:16:52.696Z" } ] ```` Track Lazada prices, monitor competitors, and mirror catalogs across SEA with **Lazada Listings Scraper** today! 🚀 # Actor input Schema ## `startUrls` (type: `array`): Explicit Lazada URLs to scrape. Accepts product detail pages (`/products/...-iXXXXX.html`), search pages (`/catalog/?q=...`), and category browse pages (`/shop-{slug}/`). ## `searchQueries` (type: `array`): Free-text keywords to search. The scraper hits `/catalog/?q={query}&page={n}`. Page 1 is skipped by default because Lazada serves a promo landing module there — use `searchStartPage` to override. ## `categories` (type: `array`): Lazada category slugs to browse (e.g. `mobiles`, `laptops`, `cameras`). Scraper hits `/shop-{slug}/` — more reliable yield than text search. ## `country` (type: `string`): Target Lazada storefront. Each country has its own domain and currency. Affects: homepage, search/category URLs, and Scrapfly proxy country. ## `homepageOnly` (type: `boolean`): Fast mode — only fetch the country homepage and extract `window.__FIRST_SCREEN_DATA`. Returns ~30 flash-sale items per country. Billed as the cheap `homepage-item` event ($0.50 / 1k). ## `searchStartPage` (type: `integer`): First page index for search/category listings. Default 2 because Lazada's page 1 frequently serves a promo landing instead of a normal SERP grid. ## `searchEndPage` (type: `integer`): Last page index (inclusive) for search/category listings. ## `maxItems` (type: `integer`): Hard cap on the number of items pushed to the dataset. 0 = unlimited. ## Actor input object example ```json { "startUrls": [], "searchQueries": [], "categories": [ "mobiles" ], "country": "sg", "homepageOnly": false, "searchStartPage": 2, "searchEndPage": 5, "maxItems": 50 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [], "searchQueries": [], "categories": [ "mobiles" ] }; // Run the Actor and wait for it to finish const run = await client.actor("piotrv1001/lazada-listings-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [], "searchQueries": [], "categories": ["mobiles"], } # Run the Actor and wait for it to finish run = client.actor("piotrv1001/lazada-listings-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [], "searchQueries": [], "categories": [ "mobiles" ] }' | apify call piotrv1001/lazada-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=piotrv1001/lazada-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Lazada Listings Scraper", "description": "The Lazada Listings Scraper extracts product data from all six SEA storefronts (SG/MY/TH/PH/VN/ID), capturing titles, prices, discounts, sold counts, ratings, reviews, variants, sellers, and images — ideal for price monitoring, catalog research, and competitor intelligence.", "version": "0.0", "x-build-id": "lTWukSxHIVfCCwQuh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~lazada-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-lazada-listings-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/piotrv1001~lazada-listings-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-lazada-listings-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/piotrv1001~lazada-listings-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-lazada-listings-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Explicit Lazada URLs to scrape. Accepts product detail pages (`/products/...-iXXXXX.html`), search pages (`/catalog/?q=...`), and category browse pages (`/shop-{slug}/`).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQueries": { "title": "Search Queries", "type": "array", "description": "Free-text keywords to search. The scraper hits `/catalog/?q={query}&page={n}`. Page 1 is skipped by default because Lazada serves a promo landing module there — use `searchStartPage` to override.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Lazada category slugs to browse (e.g. `mobiles`, `laptops`, `cameras`). Scraper hits `/shop-{slug}/` — more reliable yield than text search.", "items": { "type": "string" } }, "country": { "title": "Country / Storefront", "enum": [ "sg", "my", "th", "ph", "vn", "id" ], "type": "string", "description": "Target Lazada storefront. Each country has its own domain and currency. Affects: homepage, search/category URLs, and Scrapfly proxy country.", "default": "sg" }, "homepageOnly": { "title": "Homepage Flash-Sale Snapshot Only", "type": "boolean", "description": "Fast mode — only fetch the country homepage and extract `window.__FIRST_SCREEN_DATA`. Returns ~30 flash-sale items per country. Billed as the cheap `homepage-item` event ($0.50 / 1k).", "default": false }, "searchStartPage": { "title": "Search/Category Start Page", "minimum": 1, "type": "integer", "description": "First page index for search/category listings. Default 2 because Lazada's page 1 frequently serves a promo landing instead of a normal SERP grid.", "default": 2 }, "searchEndPage": { "title": "Search/Category End Page", "minimum": 1, "type": "integer", "description": "Last page index (inclusive) for search/category listings.", "default": 5 }, "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Hard cap on the number of items pushed to the dataset. 0 = unlimited.", "default": 50 } } }, "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 } } }, "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 } } } } } } } } } } ```