# Zalora Listings Scraper (`piotrv1001/zalora-listings-scraper`) Actor
The Zalora Listings Scraper extracts products from Zalora stores in Malaysia, Singapore, Indonesia, the Philippines, and Hong Kong by keyword or category URL, capturing names, brands, prices, discounts, ratings, images, sellers, and colors — ideal for price monitoring and fashion market research.
- **URL**: https://apify.com/piotrv1001/zalora-listings-scraper.md
- **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.00 / 1,000 products
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 Listings Scraper
Easily extract product listings from [Zalora](https://www.zalora.com), Southeast Asia's leading online fashion marketplace. The **Zalora Listings Scraper** lets you gather structured product data — prices, discounts, brands, ratings, images, and color variants — for price monitoring, market research, and competitive analysis.
Works across multiple Zalora country stores: **Malaysia, Singapore, Indonesia, Philippines, and Hong Kong**.
### ✨ Features
- 🏷️ **Comprehensive product data**: Product names, brands, regular & sale prices, discount percentages, images, ratings, review counts, sellers, and color variants with their own SKUs.
- 🔍 **Search-based extraction**: Enter any keyword (e.g. `dress`, `nike shoes`) and scrape matching products.
- 📂 **Category scraping**: Paste Zalora category URLs (e.g. `https://www.zalora.com.my/c/women/clothing/dresses`) and scrape entire categories.
- 🌏 **Multi-country support**: Malaysia 🇲🇾, Singapore 🇸🇬, Indonesia 🇮🇩, Philippines 🇵🇭, and Hong Kong 🇭🇰 — the country is detected automatically from category URLs.
- ⚡ **Fast & efficient**: Scrapes hundreds of products per minute with no browser overhead, keeping your costs low.
- 📦 **Export anywhere**: Download results as JSON, CSV, Excel, or HTML, or fetch them via the Apify API.
### 🛠️ How It Works
1. **Enter a search query** – e.g. `dress`, or paste one or more Zalora category URLs.
2. **Pick a country** – choose which Zalora store to search in (category URLs use the country from the URL itself).
3. **Set max items** – limit how many products to scrape.
4. **Run the scraper** – get clean, structured product data in minutes.
### ⚙️ Input
| Field | Type | Description |
| --- | --- | --- |
| `search` | string | Keyword to search for (e.g. `dress`). Optional if category URLs are provided. |
| `categoryUrls` | array | Zalora category page URLs to scrape. |
| `country` | string | Country store for searches: `my`, `sg`, `id`, `ph`, or `hk`. Default: `my`. |
| `maxItems` | integer | Maximum total number of products to scrape. Default: `50`. |
| `proxyConfiguration` | object | Proxy settings. Apify proxy is recommended. |
Example input:
```json
{
"search": "dress",
"country": "my",
"maxItems": 100
}
````
### 📊 Sample Output Data
The scraper provides structured JSON output with key product details. Example:
```json
{
"configSku": "484A1BE2B9F91FGS",
"name": "Be Delicious Fresh Blossom EDP 50ML",
"brand": "DKNY Fragrances",
"price": 203,
"specialPrice": null,
"currency": "MYR",
"priceFormatted": "RM 203.00",
"specialPriceFormatted": null,
"discountPercent": null,
"productUrl": "https://www.zalora.com.my/p/dkny-fragrances-be-delicious-fresh-blossom-edp-50ml-pink-3393702",
"mainImage": "https://static-my.zacdn.com/p/dkny-fragrances-5402-2073933-1.jpg",
"images": ["https://static-my.zacdn.com/p/dkny-fragrances-5402-2073933-1.jpg"],
"breadcrumbs": ["Women", "Beauty", "Fragrance"],
"variations": [],
"rating": 5,
"reviewCount": 8,
"seller": "DKNY Fragrances Official Store MY",
"isOfficialStore": true,
"isExclusiveLaunch": false,
"isBestPriceGuarantee": false,
"country": "my",
"source": { "type": "search", "query": "dress" }
}
```
You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.
### 📋 Output Fields
| Field | Description |
| --- | --- |
| `configSku` | Unique product SKU on Zalora |
| `name` | Product name |
| `brand` | Brand name |
| `price` / `priceFormatted` | Regular price (numeric / formatted with currency) |
| `specialPrice` / `specialPriceFormatted` | Sale price, if discounted |
| `discountPercent` | Discount percentage, if on sale |
| `currency` | Store currency (MYR, SGD, IDR, PHP, HKD) |
| `productUrl` | Direct link to the product page |
| `mainImage` / `images` | Product image URLs |
| `breadcrumbs` | Category path of the product |
| `variations` | Color variants with their own SKUs, images, and links |
| `rating` / `reviewCount` | Average customer rating and number of reviews |
| `seller` / `isOfficialStore` | Seller name and official-store flag |
| `country` | Country store the product was scraped from |
| `source` | What produced this item (search query or category URL) |
### 💰 How much does it cost to scrape Zalora?
The Actor uses transparent pay-per-event pricing — you only pay for what you scrape:
| Event | Price |
| --- | --- |
| Actor start | $0.005 per run |
| Product listing scraped | $0.002 per product |
That's just **$2 per 1,000 products** — scraping a full category of 10,000 products costs about $20. Use the `maxItems` input to keep run costs under control.
### 💡 Use Cases
- **Price monitoring** – track prices and discounts of fashion products across Southeast Asia.
- **Market research** – analyze brand assortments, price ranges, and ratings per category.
- **Competitive analysis** – compare seller catalogs and official-store coverage.
- **Dropshipping & resale** – discover trending, highly rated products with deep discounts.
### ❓ FAQ
**Which Zalora countries are supported?**
Malaysia (`zalora.com.my`), Singapore (`zalora.sg`), Indonesia (`zalora.co.id`), Philippines (`zalora.com.ph`), and Hong Kong (`zalora.com.hk`).
**How many products can I scrape?**
There is no hard limit — even categories with 100,000+ products can be scraped in full. Set `maxItems` to control the run size.
**Is it legal to scrape Zalora?**
This scraper only collects publicly available product data and does not extract any personal information. However, you should always review Zalora's Terms of Service and consult legal counsel for your specific use case.
**Something not working?**
Please open an issue in the **Issues** tab of the Actor — we actively monitor and fix reported problems. Custom solutions are available on request.
Start tracking Southeast Asia's fashion market with the **Zalora Listings Scraper** today! 🚀
# Actor input Schema
## `search` (type: `string`):
Keyword to search for on Zalora (e.g. dress, nike shoes). Leave empty if you only want to scrape category URLs.
## `categoryUrls` (type: `array`):
Zalora category page URLs to scrape, e.g. https://www.zalora.com.my/c/women/dresses. All supported country domains work — the country is detected from the URL.
## `country` (type: `string`):
Zalora country store to search in. Category URLs always use the country from the URL itself.
## `maxItems` (type: `integer`):
Maximum total number of products to scrape across all sources.
## `proxyConfiguration` (type: `object`):
Proxy settings used for scraping. Apify proxy is recommended for reliable results at scale.
## Actor input object example
```json
{
"search": "dress",
"categoryUrls": [],
"country": "my",
"maxItems": 50,
"proxyConfiguration": {
"useApifyProxy": true
}
}
```
# 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 = {
"search": "dress"
};
// Run the Actor and wait for it to finish
const run = await client.actor("piotrv1001/zalora-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 = { "search": "dress" }
# Run the Actor and wait for it to finish
run = client.actor("piotrv1001/zalora-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 '{
"search": "dress"
}' |
apify call piotrv1001/zalora-listings-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=piotrv1001/zalora-listings-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Zalora Listings Scraper",
"description": "The Zalora Listings Scraper extracts products from Zalora stores in Malaysia, Singapore, Indonesia, the Philippines, and Hong Kong by keyword or category URL, capturing names, brands, prices, discounts, ratings, images, sellers, and colors — ideal for price monitoring and fashion market research.",
"version": "0.0",
"x-build-id": "VfjNZwhaVPyew6tsm"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/piotrv1001~zalora-listings-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-piotrv1001-zalora-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~zalora-listings-scraper/runs": {
"post": {
"operationId": "runs-sync-piotrv1001-zalora-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~zalora-listings-scraper/run-sync": {
"post": {
"operationId": "run-sync-piotrv1001-zalora-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": {
"search": {
"title": "Search query",
"type": "string",
"description": "Keyword to search for on Zalora (e.g. dress, nike shoes). Leave empty if you only want to scrape category URLs."
},
"categoryUrls": {
"title": "Category URLs",
"type": "array",
"description": "Zalora category page URLs to scrape, e.g. https://www.zalora.com.my/c/women/dresses. All supported country domains work — the country is detected from the URL.",
"default": [],
"items": {
"type": "string"
}
},
"country": {
"title": "Country",
"enum": [
"my",
"sg",
"id",
"ph",
"hk"
],
"type": "string",
"description": "Zalora country store to search in. Category URLs always use the country from the URL itself.",
"default": "my"
},
"maxItems": {
"title": "Max items",
"minimum": 1,
"type": "integer",
"description": "Maximum total number of products to scrape across all sources.",
"default": 50
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy settings used for scraping. Apify proxy is recommended for reliable results at scale.",
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```