# Zalora Scraper - SE Asia Fashion Products, Prices & Sellers (`scrapesage/zalora-scraper`) Actor
Scrape Zalora fashion products across Singapore, Malaysia, Philippines, Hong Kong & Indonesia — names, brands, prices, discounts, sizes, stock, images, sellers, ratings & reviews. Search by keyword, segment, brand, category or URL. Monitor price drops. No login or API key. Export JSON, CSV, Excel.
- **URL**: https://apify.com/scrapesage/zalora-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $4.00 / 1,000 product scrapeds
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 Scraper — SE Asia Fashion Products, Prices, Sizes & Sellers
Extract **complete product data from [Zalora](https://www.zalora.sg)** — Southeast Asia's largest online fashion & lifestyle retailer — across **Singapore, Malaysia, the Philippines, Hong Kong and Indonesia**. Search by keyword, browse whole segments, target a brand, category or seller, or paste any Zalora URL, and get every product's **name, brand, price, sale price & discount, sizes with live stock, full image gallery, seller/merchant, rating and reviews** — plus the complete product description, specifications and care info on demand.
No login, no API key, no browser — this actor reads Zalora's own catalog API and product pages directly, so the output is first-party, fast and reliable, with country-matched residential proxying and retry-on-block built in.
### Why this Zalora scraper?
Most "fashion scrapers" grab a title and a price and stop. This actor pulls the **richest dataset in the category** and is built for the highest-value e-commerce jobs: **price & discount monitoring, competitor and assortment research, and seller/brand intelligence**.
| Data | Typical scrapers | This actor |
|---|---|---|
| Product name + brand | ✅ | ✅ |
| Current price + currency | ✅ | ✅ |
| **Sale price + discount % + amount saved** | ❌ | ✅ |
| **Full image gallery** | partial | ✅ |
| Category breadcrumb path | ❌ | ✅ |
| Rating + review count | partial | ✅ |
| **Seller / merchant + official-store flag** | ❌ | ✅ |
| **Every size with live stock quantity** | ❌ | ✅ opt-in |
| Full description + specifications + care | ❌ | ✅ opt-in |
| Colour, material attributes, USPs | ❌ | ✅ opt-in |
| Shipping, returns & delivery info | ❌ | ✅ opt-in |
| Price-drop & new-arrival **monitor mode** | ❌ | ✅ |
| 5 Southeast Asian markets in one actor | ❌ | ✅ |
| One clean dataset, no empty columns | ❌ | ✅ |
### Use cases
- **Price & discount monitoring** — track current price, sale price, discount % and amount saved across a search, segment or brand; schedule it and use monitor mode to get **only** the products whose price changed.
- **Competitor & assortment research** — pull a whole category or brand catalog with prices, ratings and review counts to size demand, benchmark assortments and spot pricing gaps across SE Asia.
- **Seller & brand intelligence / lead gen** — see which marketplace sellers and official stores list each product (`sellerName`, `officialStore`), and target a single merchant's whole catalog by `sellerIds`.
- **Stock & availability tracking** — turn on details to capture every size with its live stock quantity, and watch for sell-outs and restocks.
- **Dropshipping & sourcing** — compare products, variants, images and prices across markets and currencies.
- **Trend & merchandising analysis** — sort by newest arrivals or biggest discount, and analyse breadcrumbs, brands and review signals to see what's selling.
### How to use
1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor.
2. Open the **Zalora Scraper**, pick a **market** (Singapore by default), enter **search queries** (e.g. `dress`, `running shoes`) or **segments** (`women`, `men`, `kids`), set your filters, and click **Start**.
3. Watch results stream into the dataset table.
4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2).
### Input
```json
{
"country": "sg",
"searchQueries": ["summer dress"],
"segments": ["women"],
"sort": "discount",
"onSaleOnly": true,
"priceMax": 80,
"includeProductDetails": true,
"maxItems": 100,
"monitorMode": false
}
````
- **country** *(default `sg`)* — which Zalora market to scrape: `sg` (Singapore), `my` (Malaysia), `ph` (Philippines), `hk` (Hong Kong), `id` (Indonesia). Each returns its own catalog, currency and local pricing.
- **searchQueries** — keywords to search the catalog (e.g. `running shoes`, `Nike`, `linen shirt`). Each is scraped independently.
- **segments** *(default `women`)* — browse whole catalog segments: `women`, `men`, `kids`. Combined with the sort and filters below.
- **startUrls** — paste any Zalora URLs: product pages (`/p/...`), search pages (`?q=...`), brand pages (`/c/nike/b-126`) or segment/category pages (`/c/women`).
- **sort** *(default `popularity`)* — `popularity`, `newest`, `price_low_high`, `price_high_low`, `discount`, or `rating`.
- **priceMin / priceMax** — keep only products in this current-price band (market currency). 0 = no bound.
- **onSaleOnly** *(default false)* — keep only discounted products.
- **minRating** — keep only products rated at or above this value (0–5).
- **brandIds / colors / categoryId / sellerIds** — server-side filters by brand ID, colour, category ID, or marketplace seller ID (e.g. `13164` for adidas Singapore).
- **includeProductDetails** *(default false)* — open each product page to add the full description, every size with live stock, colour, specifications, care info, seller details, shipping & returns and the full image gallery. One fast extra request per product.
- **maxItems** *(default 100)* — cap on products for the whole run.
- **maxItemsPerQuery** *(default 0 = no cap)* — optional per-query/segment cap.
- **monitorMode** *(default false)* — emit only new products and price changes (see below).
- **proxyConfiguration** — proxy settings; residential pinned to the market is the default and recommended.
### Output
One clean record per product. Use the **Products**, **Deals & discounts** and **Brands & sellers** dataset views to switch column sets.
```json
{
"configSku": "5AAC2SH19B7DE7GS",
"name": "Adizero Evo SL Shoes",
"brand": "ADIDAS",
"url": "https://www.zalora.sg/p/adidas-adizero-evo-sl-shoes-white-3914412",
"price": "S$ 209.00",
"priceValue": 209,
"specialPrice": null,
"specialPriceValue": null,
"currentPriceValue": 209,
"onSale": false,
"discountPercent": null,
"savingAmount": null,
"currency": "SGD",
"mainImage": "https://dynamic.zacdn.com/.../adidas-...-1.jpg",
"images": ["https://dynamic.zacdn.com/.../1.jpg", "..."],
"imageCount": 8,
"breadcrumbs": ["Women", "Sports", "Shoes", "Running"],
"category": "Running",
"segment": "women",
"sellerName": "adidas Singapore",
"officialStore": false,
"rating": 4.8,
"reviewCount": 161,
"specialLabel": "trending",
"isMembershipEligible": true,
"country": "SG",
"source": "zalora",
"detailScraped": true,
"description": "adidas Adizero Evo SL running shoes — lightweight, responsive …",
"color": "White",
"sizes": ["3.5", "4", "4.5", "5", "..."],
"variants": [{ "sku": "5AAC2SH19B7DE7GS-052UOP", "size": "3.5", "quantity": 15, "inStock": true }],
"sizesInStock": ["3.5", "4", "4.5"],
"totalStock": 104,
"inStock": true,
"sellerId": "13164",
"shippingCost": "Free Delivery",
"returnPeriodDays": 30,
"uniqueSellingPoints": ["100% Original Product", "Free exchange/return (up to 30 days)"],
"scrapedAt": "2026-06-26T16:00:00.000Z"
}
```
The first block is always present (catalog data). The second block is added when **includeProductDetails** is on (product-page data: description, sizes, stock, colour, specs, seller, shipping/returns, full gallery).
#### What to expect (field coverage)
Verified across multiple segments, brands and markets:
| Field | Coverage |
|---|---|
| name, brand, price, currency, url, images, breadcrumbs/category, segment, sellerName | ~100% |
| **sale price, discount %, amount saved** | present for every **on-sale** product (full-price items have none, by design) |
| rating, reviewCount | present for products with reviews (new arrivals often have none) |
| **description, sizes, variants + stock, colour, shipping, returns, USPs** | ~100% when `includeProductDetails` is on |
| specifications, care info, ingredients | present for categories that publish them (specs for performance/electronics, care for apparel, ingredients for beauty) |
A blank field means Zalora doesn't publish that value for that product — not that scraping failed. Nothing is dropped, so you always get the richest record available.
### Monitor mode — only new products & price changes
Turn on **monitorMode** and the actor remembers every product in a named key-value store, then emits **only** products that are new or whose price changed since the last run. Each changed record carries a `monitorStatus` (`new`, `price_drop` or `price_increase`) and the `previousPrice`.
It **complements [Apify Schedules](https://docs.apify.com/platform/schedules)** rather than conflicting with them: the Schedule starts the run on your cadence (hourly/daily), and monitor mode deduplicates the results against prior runs so your downstream systems only see real changes. Use `dedupStoreName` to run several independent monitors (e.g. one per saved search).
### Automate & schedule
Run this actor on autopilot and pull results into your own stack:
- **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** — run it hourly/daily to track prices, discounts and new arrivals; pair with monitor mode for change-only output.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (repricer, CRM import, Slack alert) the moment a run finishes.
```js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });
const run = await client.actor('scrapesage/zalora-scraper').call({
country: 'sg',
segments: ['women'],
sort: 'discount',
onSaleOnly: true,
includeProductDetails: true,
monitorMode: true,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} products & changes`);
```
### Integrate with any app
Connect the dataset to 5,000+ apps — no code required:
- **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push price drops or new products straight into your tools.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored product drops in price or a new arrival lands.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases.
### Use with AI assistants (MCP)
The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find every discounted women's dress under S$50 on Zalora with its sizes in stock" and let it run the scraper for you.
### More scrapers from scrapesage
Build a complete **e-commerce, marketplace & Southeast-Asia intelligence stack**:
- **[Amazon Scraper](https://apify.com/scrapesage/amazon-scraper)** — products, prices, reviews, variations & seller leads across 20+ marketplaces.
- **[Shopify Store Scraper](https://apify.com/scrapesage/shopify-store-scraper)** — products, variants, prices & merchant leads from any Shopify store.
- **[AliExpress Scraper](https://apify.com/scrapesage/aliexpress-scraper)** — products, live prices, SKUs, reviews & supplier leads.
- **[eBay Scraper](https://apify.com/scrapesage/ebay-scraper)** — listings, sold comps, item detail & seller leads.
- **[Poshmark Scraper](https://apify.com/scrapesage/poshmark-scraper)** — fashion resale listings, sold comps & seller leads.
- **[foodpanda Scraper](https://apify.com/scrapesage/foodpanda-scraper)** — restaurants, menus and B2B leads across Singapore & APAC.
- **[PropertyGuru Scraper](https://apify.com/scrapesage/propertyguru-scraper)** — Singapore property listings and agent leads.
- **[99.co Property Scraper](https://apify.com/scrapesage/99-co-property-scraper)** — Singapore property listings and agent leads.
- **[SGCarMart Scraper](https://apify.com/scrapesage/sgcarmart-used-car-scraper)** — Singapore used-car listings and dealer leads.
- **[Burpple Scraper](https://apify.com/scrapesage/burpple-scraper)** — Singapore restaurant, cafe & hawker discovery and leads.
### Tips
- **Cheapest discovery**: leave `includeProductDetails` off for a fast, cheap catalog sweep (name, brand, price, sale price, images, rating, seller). Turn it on when you need sizes, stock, description and specs.
- **Best deals first**: set `sort` to `discount` and `onSaleOnly` to true to surface the biggest markdowns.
- **Target one brand or seller**: read a brand ID from a brand URL (`/c/nike/b-126` → `126`) into `brandIds`, or a seller ID into `sellerIds`, to scrape just that catalog.
- **Breadth via many queries**: add several `searchQueries` rather than paginating very deep into one — it's faster and more reliable.
- **Recurring monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` to capture only new arrivals and price drops.
- **Reliability**: keep the default residential proxy pinned to your chosen market — Zalora protects its site with PerimeterX, and country-matched residential IPs are the most reliable.
### FAQ
**Which Zalora markets are supported?** Singapore (`sg`), Malaysia (`my`), the Philippines (`ph`), Hong Kong (`hk`) and Indonesia (`id`). Each returns its own catalog, currency and local pricing. Pick one per run with the `country` field.
**Does it need a Zalora account or API key?** No. This actor reads Zalora's own public catalog API and product pages — the same data the website shows — with no login, cookie or key.
**How do I scrape a whole category or brand?** Paste the category or brand URL into `startUrls` (e.g. `/c/women` or `/c/nike/b-126`), or use `segments` plus `brandIds` / `categoryId` filters.
**Can I get every size and its stock?** Yes — turn on `includeProductDetails`. Each product then carries a `variants` array with every size, its live stock `quantity` and an `inStock` flag, plus `sizesInStock` and `totalStock`.
**How do I monitor price drops?** Turn on `monitorMode` and run the actor on a [Schedule](https://docs.apify.com/platform/schedules). You'll get only new products and price changes, each tagged `new`, `price_drop` or `price_increase` with the `previousPrice`.
**Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive).
**A field is empty — why?** Some products genuinely have no sale price (not discounted), no reviews yet, or no published specs/care info. Fields are blank only when Zalora doesn't publish that value — never because the scraper skipped it.
**Is scraping Zalora legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws (e.g. PDPA/GDPR) and Zalora's terms.
### Need help?
Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained.
# Actor input Schema
## `country` (type: `string`):
Which Zalora marketplace to scrape. Each market returns its own catalog, currency and local pricing.
## `searchQueries` (type: `array`):
Keywords to search the Zalora catalog, e.g. running shoes, summer dress, Nike. Each query is scraped independently.
## `segments` (type: `array`):
Browse whole catalog segments instead of (or in addition to) searching. Common values: women, men, kids. Combined with the sort and filters below.
## `startUrls` (type: `array`):
Paste any Zalora URLs: product pages (/p/...), search pages (?q=...), brand pages (/c/nike/b-126), or segment/category pages (/c/women). Used in addition to the queries and segments above.
## `sort` (type: `string`):
Ordering of catalog/search results.
## `priceMin` (type: `integer`):
Only keep products whose current price is at least this amount (in the market's currency). 0 = no minimum.
## `priceMax` (type: `integer`):
Only keep products whose current price is at most this amount. 0 = no maximum.
## `onSaleOnly` (type: `boolean`):
Only keep products that are discounted (have a special / sale price).
## `minRating` (type: `number`):
Only keep products with an average rating at or above this value (0–5). 0 = no rating filter.
## `brandIds` (type: `array`):
Filter by Zalora brand IDs (the number in a brand URL, e.g. 126 from /c/nike/b-126). Leave empty for all brands.
## `colors` (type: `array`):
Filter by colour, e.g. black, white, red, blue, beige.
## `categoryId` (type: `string`):
Optional Zalora category ID to narrow a segment (e.g. clothing, shoes, bags). Advanced — read it from the catalog page's category facet.
## `sellerIds` (type: `array`):
Filter to specific marketplace sellers / stores by Zalora seller ID (e.g. 13164 for adidas Singapore). Useful for tracking one merchant's catalog.
## `includeProductDetails` (type: `boolean`):
Open each product page to add the full description, every size with live stock, colour, attributes/specifications, care instructions, seller info, shipping & returns, full image gallery and review tags. Adds one fast page fetch per product.
## `maxItems` (type: `integer`):
Maximum number of products to scrape across all queries/segments. Keep modest for quick runs.
## `maxItemsPerQuery` (type: `integer`):
Optional cap per individual search query / segment / source. 0 = no per-query cap.
## `monitorMode` (type: `boolean`):
Remember products across runs and emit only NEW products and those whose price changed (tagged new / price\_drop / price\_increase). Pair with Apify Schedules to track prices and new arrivals automatically.
## `dedupStoreName` (type: `string`):
Key-value store name that holds the monitor state. Use a different name per saved search you want to track independently.
## `maxConcurrency` (type: `integer`):
Parallel product-detail page fetches when 'Include full product details' is on.
## `proxyConfiguration` (type: `object`):
Proxies to use. Residential proxies pinned to the chosen market are strongly recommended — Zalora protects its site with PerimeterX and country-matched residential IPs are the most reliable.
## Actor input object example
```json
{
"country": "sg",
"searchQueries": [
"dress"
],
"segments": [
"women"
],
"sort": "popularity",
"priceMin": 0,
"priceMax": 0,
"onSaleOnly": false,
"minRating": 0,
"includeProductDetails": false,
"maxItems": 100,
"maxItemsPerQuery": 0,
"monitorMode": false,
"dedupStoreName": "zalora-monitor",
"maxConcurrency": 6,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# Actor output Schema
## `results` (type: `string`):
All scraped Zalora products in the default dataset. One clean row per product.
# 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 = {
"searchQueries": [
"dress"
],
"segments": [
"women"
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/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 = {
"searchQueries": ["dress"],
"segments": ["women"],
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
},
}
# Run the Actor and wait for it to finish
run = client.actor("scrapesage/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 '{
"searchQueries": [
"dress"
],
"segments": [
"women"
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call scrapesage/zalora-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapesage/zalora-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Zalora Scraper - SE Asia Fashion Products, Prices & Sellers",
"description": "Scrape Zalora fashion products across Singapore, Malaysia, Philippines, Hong Kong & Indonesia — names, brands, prices, discounts, sizes, stock, images, sellers, ratings & reviews. Search by keyword, segment, brand, category or URL. Monitor price drops. No login or API key. Export JSON, CSV, Excel.",
"version": "0.1",
"x-build-id": "jp74Iz3hYxxyiuATP"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~zalora-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~zalora-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-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/scrapesage~zalora-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-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",
"properties": {
"country": {
"title": "Market / country",
"enum": [
"sg",
"my",
"ph",
"hk",
"id"
],
"type": "string",
"description": "Which Zalora marketplace to scrape. Each market returns its own catalog, currency and local pricing.",
"default": "sg"
},
"searchQueries": {
"title": "Search queries",
"type": "array",
"description": "Keywords to search the Zalora catalog, e.g. running shoes, summer dress, Nike. Each query is scraped independently.",
"items": {
"type": "string"
}
},
"segments": {
"title": "Segments (browse)",
"type": "array",
"description": "Browse whole catalog segments instead of (or in addition to) searching. Common values: women, men, kids. Combined with the sort and filters below.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Paste any Zalora URLs: product pages (/p/...), search pages (?q=...), brand pages (/c/nike/b-126), or segment/category pages (/c/women). Used in addition to the queries and segments above.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"sort": {
"title": "Sort by",
"enum": [
"popularity",
"newest",
"price_low_high",
"price_high_low",
"discount",
"rating"
],
"type": "string",
"description": "Ordering of catalog/search results.",
"default": "popularity"
},
"priceMin": {
"title": "Min price",
"minimum": 0,
"type": "integer",
"description": "Only keep products whose current price is at least this amount (in the market's currency). 0 = no minimum.",
"default": 0
},
"priceMax": {
"title": "Max price",
"minimum": 0,
"type": "integer",
"description": "Only keep products whose current price is at most this amount. 0 = no maximum.",
"default": 0
},
"onSaleOnly": {
"title": "On sale only",
"type": "boolean",
"description": "Only keep products that are discounted (have a special / sale price).",
"default": false
},
"minRating": {
"title": "Minimum rating",
"minimum": 0,
"maximum": 5,
"type": "number",
"description": "Only keep products with an average rating at or above this value (0–5). 0 = no rating filter.",
"default": 0
},
"brandIds": {
"title": "Brand IDs",
"type": "array",
"description": "Filter by Zalora brand IDs (the number in a brand URL, e.g. 126 from /c/nike/b-126). Leave empty for all brands.",
"items": {
"type": "string"
}
},
"colors": {
"title": "Colours",
"type": "array",
"description": "Filter by colour, e.g. black, white, red, blue, beige.",
"items": {
"type": "string"
}
},
"categoryId": {
"title": "Category ID",
"type": "string",
"description": "Optional Zalora category ID to narrow a segment (e.g. clothing, shoes, bags). Advanced — read it from the catalog page's category facet."
},
"sellerIds": {
"title": "Seller IDs",
"type": "array",
"description": "Filter to specific marketplace sellers / stores by Zalora seller ID (e.g. 13164 for adidas Singapore). Useful for tracking one merchant's catalog.",
"items": {
"type": "string"
}
},
"includeProductDetails": {
"title": "Include full product details",
"type": "boolean",
"description": "Open each product page to add the full description, every size with live stock, colour, attributes/specifications, care instructions, seller info, shipping & returns, full image gallery and review tags. Adds one fast page fetch per product.",
"default": false
},
"maxItems": {
"title": "Max products",
"minimum": 1,
"type": "integer",
"description": "Maximum number of products to scrape across all queries/segments. Keep modest for quick runs.",
"default": 100
},
"maxItemsPerQuery": {
"title": "Max products per query",
"minimum": 0,
"type": "integer",
"description": "Optional cap per individual search query / segment / source. 0 = no per-query cap.",
"default": 0
},
"monitorMode": {
"title": "Monitor mode (only new / changed)",
"type": "boolean",
"description": "Remember products across runs and emit only NEW products and those whose price changed (tagged new / price_drop / price_increase). Pair with Apify Schedules to track prices and new arrivals automatically.",
"default": false
},
"dedupStoreName": {
"title": "Monitor store name",
"type": "string",
"description": "Key-value store name that holds the monitor state. Use a different name per saved search you want to track independently.",
"default": "zalora-monitor"
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "Parallel product-detail page fetches when 'Include full product details' is on.",
"default": 6
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxies to use. Residential proxies pinned to the chosen market are strongly recommended — Zalora protects its site with PerimeterX and country-matched residential IPs are the most reliable.",
"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
}
}
}
}
}
}
}
}
}
}
```