# Zalora Products Scraper (`polished_tripod/zalora-scraper`) Actor Scrape product listings from Zalora — the largest fashion e-commerce in Southeast Asia. Extract prices, brands, ratings, discounts and images across 6 countries: Malaysia, Singapore, Indonesia, Thailand, Philippines, Vietnam. - **URL**: https://apify.com/polished\_tripod/zalora-scraper.md - **Developed by:** [Ilia Bratkovsky](https://apify.com/polished_tripod) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results 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 ## Zalora Products Scraper Extract product listing data from Zalora via its internal product API with pagination, anti-bot session warm-up, and structured output. ### Who Is It For - Fashion analysts - Brands and retail teams - Marketing and e-commerce agencies - Dropshippers and sourcing teams - Price monitoring and competitive intelligence teams ### Supported Countries - Malaysia - Singapore - Indonesia - Thailand - Philippines - Vietnam ### Output Fields | Field | Description | |---|---| | `productId` | Zalora product SKU/config identifier. | | `name` | Product title. | | `brand` | Brand name. | | `url` | Absolute URL of the product page. | | `priceOriginal` | Original/list price as numeric value. | | `priceCurrent` | Current selling price as numeric value. | | `discountPercent` | Calculated discount percentage, or `null` if no discount. | | `priceFormatted` | Original/list price in formatted currency text (e.g. `RM 139.00`). | | `specialPriceFormatted` | Discounted price in formatted text, or `null`. | | `imageUrl` | Main product image URL. | | `categories` | Category breadcrumb array from Zalora taxonomy. | | `label` | Product badge/label (markdown or special label), or `null`. | | `rating` | Average rating value, or `null`. | | `reviewCount` | Number of reviews, or `null`. | | `supplier` | Supplier or seller name. | | `country` | Country code of the market (`my`, `sg`, `id`, `th`, `ph`, `vn`). | | `currency` | Market currency (`MYR`, `SGD`, `IDR`, `THB`, `PHP`, `VND`). | | `searchKeyword` | Keyword used for this result row (keyword mode). | | `category` | Category input value used for this row (category mode). | | `scrapedAt` | ISO timestamp of extraction. | ### Example Input JSON ```json { "searchKeywords": ["jeans", "dress"], "categories": [], "countries": ["my", "sg"], "maxProducts": 100, "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` ### Example Output JSON ```json { "productId": "08D7AAA2C8BBD9GS", "name": "Crew Neck Knit Dress", "brand": "Alacati", "url": "https://www.zalora.com.my/p/alacati-crew-neck-knit-dress-grey-4026546", "priceOriginal": 139, "priceCurrent": 139, "discountPercent": null, "priceFormatted": "RM 139.00", "specialPriceFormatted": null, "imageUrl": "https://dynamic.zacdn.com/6rS_tyAq7kScKSNJ0EqKoEgInYk=/0x770/filters:quality(70):format(webp)/https://static-my.zacdn.com/p/alacati-0782-6456204-1.jpg", "categories": ["Women", "Clothing", "Dresses", "Bodycon Dresses"], "label": null, "rating": 4.4, "reviewCount": 43, "supplier": "ZALORA", "country": "my", "currency": "MYR", "searchKeyword": "dress", "category": null, "scrapedAt": "2026-03-27T11:56:54.947Z" } ``` ### Use Cases 1. Monitor daily price and discount changes across Zalora markets. 2. Benchmark your brand against competing products by category and country. 3. Track assortment breadth by brand, category tree, and supplier. 4. Build SEA fashion trend datasets for BI dashboards and forecasting. 5. Source products for marketplace operations and dropshipping workflows. ### FAQ **Do I need residential proxies?**\ Yes. Zalora uses anti-bot protection, so residential proxies are strongly recommended for stable runs. **How is pagination handled?**\ The actor paginates automatically using API `offset` and stops at `maxProducts` or when no more products are returned. **Can I run multiple countries in one execution?**\ Yes. Provide multiple country codes in `countries`; the actor processes each market in the same run. # Actor input Schema ## `searchKeywords` (type: `array`): List of keywords to search for on Zalora (e.g. 'dress', 'shoes', 'bags'). ## `categories` (type: `array`): Category URL paths to scrape (e.g. 'women/dresses', 'men/shirts'). ## `startUrls` (type: `array`): Direct URLs to scrape. If provided, keywords and categories are ignored. ## `countries` (type: `array`): Country codes to scrape: sg, my, id, th, ph, vn. ## `maxProducts` (type: `integer`): Maximum number of products to scrape per keyword×country combination. ## `proxy` (type: `object`): Proxy settings. Residential proxies are strongly recommended — Zalora blocks datacenter IPs. ## Actor input object example ```json { "searchKeywords": [ "dress" ], "categories": [], "startUrls": [], "countries": [ "my" ], "maxProducts": 100, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("polished_tripod/zalora-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 = {} # Run the Actor and wait for it to finish run = client.actor("polished_tripod/zalora-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 '{}' | apify call polished_tripod/zalora-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=polished_tripod/zalora-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zalora Products Scraper", "description": "Scrape product listings from Zalora — the largest fashion e-commerce in Southeast Asia. Extract prices, brands, ratings, discounts and images across 6 countries: Malaysia, Singapore, Indonesia, Thailand, Philippines, Vietnam.", "version": "0.1", "x-build-id": "hA8yeCkyPlE7FDJH3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/polished_tripod~zalora-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-polished_tripod-zalora-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/polished_tripod~zalora-scraper/runs": { "post": { "operationId": "runs-sync-polished_tripod-zalora-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/polished_tripod~zalora-scraper/run-sync": { "post": { "operationId": "run-sync-polished_tripod-zalora-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", "required": [ "countries" ], "properties": { "searchKeywords": { "title": "Search Keywords", "type": "array", "description": "List of keywords to search for on Zalora (e.g. 'dress', 'shoes', 'bags').", "default": [ "dress" ], "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Category URL paths to scrape (e.g. 'women/dresses', 'men/shirts').", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct URLs to scrape. If provided, keywords and categories are ignored.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "countries": { "title": "Countries", "type": "array", "description": "Country codes to scrape: sg, my, id, th, ph, vn.", "default": [ "my" ], "items": { "type": "string" } }, "maxProducts": { "title": "Max Products", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to scrape per keyword×country combination.", "default": 100 }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are strongly recommended — Zalora blocks datacenter IPs.", "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 } } }, "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 } } } } } } } } } } ```