Zalora API & Scraper: parameters and responses
This is the reference for the 5 Zalora endpoints under /zalora/v1 (search, category, detail, reviews and categories) and their 18 parameters. Each endpoint lists its parameters, required or optional, with allowed values and defaults, and comes with a cURL, Python and JavaScript call; every response uses the same { ok, data, meta, error } envelope.
Zalora API returns live Zalora data as clean JSON for zalora The primary endpoint, search, returns product results including config sku, name, brand, brand id and price.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Developers reach for it when they need to track product listings, prices, availability, variants and reviews without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Zalora scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, category, detail, reviews. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/zalora/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"q": "dress",
"country": "ph",
"limit": 10
}
}{
"ok": true,
"meta": {
"api": "zalora",
"endpoint": "search",
"mode": "live",
"latency_ms": 568.5,
"record_count": 10,
"bytes": 13390,
"cache_hit": false,
"stop_reason": "limit_reached",
"country": "ph",
"locale": "en-PH",
"currency": "PHP",
"total": 23669,
"page": 1,
"has_more": true,
"next_page": 2,
"dropped_out_of_band": null,
"corrected_query": null,
"charged_credits": 1,
"version": "1.0.0",
"request_id": "337b574d285e49a1",
"fetched_at": "2026-10-31T13:02:55.339Z"
},
"data": {
"products": [
{
"config_sku": "1F1A6AA0C2ECECGS",
"name": "Rita Dress",
"url": "https://www.zalora.com.ph/p/cole-vintage-rita-dress-beige-2393391",
"brand": "Cole Vintage",
"brand_id": null,
"price": 374.75,
"price_formatted": "Php 374.75",
"original_price": 1499,
"original_price_formatted": "Php 1,499.00",
"currency": "PHP",
"discount_pct": 75,
"discount_label": "75% OFF",
"saving_amount": null,
"rating": 5,
"review_count": 2,
"seller": "Cole Vintage",
"official_store": null,
"image_url": "https://static-ph.zacdn.com/p/cole-vintage-0227-1933932-1.jpg",
"images": [
"https://static-ph.zacdn.com/p/cole-vintage-0227-1933932-1.jpg",
"https://static-ph.zacdn.com/p/cole-vintage-0227-1933932-2.jpg",
"https://static-ph.zacdn.com/p/cole-vintage-0227-1933932-3.jpg"
],
"category_breadcrumb": [
"Women",
"Clothing",
"Dresses"
],
"category_ids": null,
"color": null,
"label": null,
"sponsored": false,
"has_different_simple_prices": true,
"is_membership_eligible": null
},
{
"config_sku": "5D74EAACAA73F7GS",
"name": "Bow Maxi Dress",
"url": "https://www.zalora.com.ph/p/trendyol-bow-maxi-dress-black-4223162",
"brand": "Trendyol",
"brand_id": null,
"price": 3199,
"price_formatted": "Php 3,199.00",
"original_price": 3999,
"original_price_formatted": "Php 3,999.00",
"currency": "PHP",
"discount_pct": 20,
"discount_label": "20% OFF",
"saving_amount": null,
"rating": 4.2,
"review_count": 9,
"seller": "ZALORA",
"official_store": null,
"image_url": "https://static-ph.zacdn.com/p/trendyol-6997-2613224-1.jpg",
"images": [
"https://static-ph.zacdn.com/p/trendyol-6997-2613224-1.jpg",
"https://static-ph.zacdn.com/p/trendyol-6997-2613224-2.jpg",
"https://static-ph.zacdn.com/p/trendyol-6998-2613224-3.jpg"
],
"category_breadcrumb": [
"Women",
"Clothing",
"Dresses"
],
"category_ids": null,
"color": null,
"label": "zalora_exclusive",
"sponsored": false,
"has_different_simple_prices": false,
"is_membership_eligible": null
},
{
"config_sku": "42F9CAA9B5CA8EGS",
"name": "Draped Satin Midi Dress",
"url": "https://www.zalora.com.ph/p/other-stories-draped-satin-midi-dress-pink-3770958",
"brand": "& Other Stories",
"brand_id": null,
"price": 3797.5,
"price_formatted": "Php 3,797.50",
"original_price": 7595,
"original_price_formatted": "Php 7,595.00",
"currency": "PHP",
"discount_pct": 50,
"discount_label": "50% OFF",
"saving_amount": null,
"rating": 3.8,
"review_count": 4,
"seller": "ZALORA",
"official_store": null,
"image_url": "https://static-ph.zacdn.com/p/other-stories-6075-8590773-1.jpg",
"images": [
"https://static-ph.zacdn.com/p/other-stories-6075-8590773-1.jpg",
"https://static-ph.zacdn.com/p/other-stories-6075-8590773-2.jpg",
"https://static-ph.zacdn.com/p/other-stories-6076-8590773-3.jpg"
],
"category_breadcrumb": [
"Women",
"Clothing",
"Dresses"
],
"category_ids": null,
"color": null,
"label": null,
"sponsored": false,
"has_different_simple_prices": false,
"is_membership_eligible": true
}
]
}
}What the Zalora API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search one Zalora country storefront by keyword, with the site's own filters (brand, category, colour, size, price range, minimum rating, minimum discount, seller) and sorts. Returns up to 100 products per page with the sale price, the struck-through original, the discount badge, rating, review count, seller, images and the category breadcrumb. Set include_sponsored to also get the promoted rows Zalora shows first. | Pricing teams call search to search one Zalora country storefront by keyword, with the site's own filters (brand, category…. | q, country, page, limit, sort, ... |
| category | List every product in one Zalora category, without a keyword — the same rows and the same filters/sorts as `search`, driven by a numeric category_id from the `categories` action. Use it to walk a whole department (e.g. all Summer Dresses) rather than to answer a query. | Marketplace operators call category to list every product in one Zalora category, without a keyword. | category_id, country, page, limit, sort, ... |
| detail | Full product detail by config_sku, product slug or product URL: sale price, struck original, saving amount, discount badge, brand, seller, rating and review count, the full attribute table (material, care, fit, colour…), every size variant with its own stock count and price, the image gallery, delivery/return terms and the category breadcrumb. | Catalog enrichment teams call detail to get full product detail by config_sku, product slug or product URL. | config_sku, country |
| reviews | Customer reviews for one product by config_sku, slug or URL: star rating, review text, the reviewer's own quality tags, the display handle Zalora publishes (already masked at the source) and the aggregate rating / review count / most-mentioned tags. | Retail analysts call reviews to get customer reviews for one product by config_sku, slug or URL. | config_sku, country, limit, cursor |
| categories | The whole Zalora category tree for a country (about 1 800 nodes on PH), optionally narrowed to one segment. Each node carries its numeric category_id, name, parent id, segment and url key — this is where the category_id for `search` / `category` comes from. | Pricing teams call categories to get the whole Zalora category tree for a country (about 1 800 nodes on PH), optionally narrowed t…. | country, segment |
Call search from your stack
curl -X POST https://api.reefapi.com/zalora/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"q":"dress","country":"ph","limit":10}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/zalora/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"q": "dress",
"country": "ph",
"limit": 10
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/zalora/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"q": "dress",
"country": "ph",
"limit": 10
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.zalora.search with {"q":"dress","country":"ph","limit":10}.Who uses this API and why
- Pricing teams use Zalora to search one Zalora country storefront by keyword, with the site's own filters (brand, category….
- Marketplace operators use Zalora to list every product in one Zalora category, without a keyword.
- Catalog enrichment teams use Zalora to get full product detail by config_sku, product slug or product URL.
- Retail analysts use Zalora to get customer reviews for one product by config_sku, slug or URL.
- Pricing teams use Zalora to get the whole Zalora category tree for a country (about 1 800 nodes on PH), optionally narrowed t….
Questions developers ask before integrating
What is the Zalora API?
Zalora API is a ReefAPI endpoint group for zalora It returns live JSON through POST requests under /zalora/v1.
Is the Zalora API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Zalora calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Zalora login or account?
No login to Zalora is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Zalora data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Zalora API use?
Zalora actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Zalora from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call zalora actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Zalora API a Zalora scraper?
It is the managed alternative to a DIY Zalora scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same zalora back as clean JSON.
Why does my Zalora scraper keep getting blocked?
Most Zalora scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.