# Zalora API scraper — Southeast Asia's largest fashion marketplace (Philippines, Singapore, Malaysia, Indonesia, Hong Kong): keyword product search with Zalora's own brand / category / colour / size / price / rating / discount facets and sorts, full product detail with per-size stock and attributes, customer reviews, and the complete category tree — live prices in PHP/SGD/MYR/IDR/HKD, no API key required

> 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.
> ReefAPI engine `zalora` · 5 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/zalora/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/zalora/v1/search — 1 credit
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.

**Parameters:**
- `q` (string, required) — Search keyword — a product type, brand or description ('summer dress', 'nike air force', 'linen shirt', 'tas wanita').
- `country` (enum, optional, default "ph") — Which Zalora country storefront to read. Catalogue, prices and currency differ per country; Taiwan is not served by Zalora any more and is not offered here. [one of: ph, sg, my, id, hk]
- `page` (integer, optional, default 1) — 1-based page number. Page forward with meta.next_page until meta.has_more is false.
- `limit` (integer, optional, default 40) — Rows per page, 1-100 (the source caps at 100; a larger value is clamped, not rejected).
- `sort` (enum, optional, default "popularity") — Result ordering — Zalora's own sort options, exactly as the site offers them. Note that Zalora's price sort steers the page rather than strictly ordering it: over 100 rows of the same query the cheapest-first page averaged 858 PHP and the dearest-first page 16 340 PHP, but neither page is monotonic. Sort to bias the results, filter with price_min / price_max to bound them. [one of: popularity, top_rated, price_low_to_high, price_high_to_low, latest_arrival, discount, top_selling]
- `price_min` (number, optional) — Minimum price, in the country's own currency unit (PHP/SGD/MYR/IDR/HKD — see meta.currency). Compared against the price that is actually charged (the sale price when an item is marked down); every returned row is inside the band.
- `price_max` (number, optional) — Maximum price, in the country's own currency unit. Every returned row is inside the band; a page may therefore hold fewer rows than `limit` (meta.dropped_out_of_band counts them).
- `rating_min` (enum, optional) — Keep only products rated at least this many stars. [one of: 2, 3, 4, 5]
- `discount_min` (integer, optional) — Keep only products marked down by at least this percentage.
- `color` (string, optional) — Colour facet, lowercase as Zalora publishes it (black, white, blue, beige, red, green, pink, multi…). Comma-separate for several.
- `size` (string, optional) — Size facet in Zalora's own '<system>_<size>' notation (International_M, US_8, EU_38, AUS_6). Comma-separate for several.
- `brand_id` (string, optional) — Numeric Zalora brand id (the `brand_id` of any product row). Comma-separate for several brands.
- `category_id` (string, optional) — Numeric Zalora category id — take it from the `categories` action or from a product's `category_ids`.
- `seller_id` (string, optional) — Numeric seller/store id — lists only that store's products.
- `include_sponsored` (boolean, optional, default false) — Also return the promoted rows Zalora places at the TOP of its own result page. They are returned first and flagged `sponsored: true`; off by default so organic ranking is clean.

**Returns:** products[]{config_sku, name, url, brand, brand_id, price, price_formatted, original_price, original_price_formatted, currency, discount_pct, discount_label, rating, review_count, seller, image_url, images[], category_breadcrumb[], category_ids[], color, label, sponsored} + meta{total, page, has_more, next_page, country, currency}

**Example request body:**
```json
{
  "q": "dress",
  "country": "ph",
  "limit": 10
}
```

### POST https://api.reefapi.com/zalora/v1/category — 1 credit
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.

**Parameters:**
- `category_id` (string, required) — Numeric Zalora category id to list (e.g. 7476 = Summer Dresses on PH). Get ids from the `categories` action.
- `country` (enum, optional, default "ph") — Which Zalora country storefront to read. Catalogue, prices and currency differ per country; Taiwan is not served by Zalora any more and is not offered here. [one of: ph, sg, my, id, hk]
- `page` (integer, optional, default 1) — 1-based page number. Page forward with meta.next_page until meta.has_more is false.
- `limit` (integer, optional, default 40) — Rows per page, 1-100 (the source caps at 100; a larger value is clamped, not rejected).
- `sort` (enum, optional, default "popularity") — Result ordering — Zalora's own sort options, exactly as the site offers them. Note that Zalora's price sort steers the page rather than strictly ordering it: over 100 rows of the same query the cheapest-first page averaged 858 PHP and the dearest-first page 16 340 PHP, but neither page is monotonic. Sort to bias the results, filter with price_min / price_max to bound them. [one of: popularity, top_rated, price_low_to_high, price_high_to_low, latest_arrival, discount, top_selling]
- `price_min` (number, optional) — Minimum price, in the country's own currency unit (PHP/SGD/MYR/IDR/HKD — see meta.currency). Compared against the price that is actually charged (the sale price when an item is marked down); every returned row is inside the band.
- `price_max` (number, optional) — Maximum price, in the country's own currency unit. Every returned row is inside the band; a page may therefore hold fewer rows than `limit` (meta.dropped_out_of_band counts them).
- `rating_min` (enum, optional) — Keep only products rated at least this many stars. [one of: 2, 3, 4, 5]
- `discount_min` (integer, optional) — Keep only products marked down by at least this percentage.
- `color` (string, optional) — Colour facet, lowercase as Zalora publishes it (black, white, blue, beige, red, green, pink, multi…). Comma-separate for several.
- `size` (string, optional) — Size facet in Zalora's own '<system>_<size>' notation (International_M, US_8, EU_38, AUS_6). Comma-separate for several.
- `brand_id` (string, optional) — Numeric Zalora brand id (the `brand_id` of any product row). Comma-separate for several brands.
- `seller_id` (string, optional) — Numeric seller/store id — lists only that store's products.

**Returns:** products[]{…same shape as search…} + meta{total, page, has_more, next_page, country, currency}

**Example request body:**
```json
{
  "category_id": "7476"
}
```

### POST https://api.reefapi.com/zalora/v1/detail — 1 credit
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.

**Parameters:**
- `config_sku` (string, required) — Zalora product handle: the `config_sku` from a search row (AE5AFACBFDC607GS), the product-page slug, or a full product URL (zalora.<tld>/p/<slug>) — all three resolve.
- `country` (enum, optional, default "ph") — Which Zalora country storefront to read. Catalogue, prices and currency differ per country; Taiwan is not served by Zalora any more and is not offered here. [one of: ph, sg, my, id, hk]

**Returns:** product{config_sku, name, url, brand, price, price_formatted, original_price, currency, discount_pct, saving_amount, rating, review_count, seller, seller_id, description, attributes{}, variants[]{simple_sku, size, quantity, price}, in_stock, total_stock, images[], media[], category_breadcrumb[], return_period_days, tags[]}

**Example request body:**
```json
{
  "config_sku": "AE5AFACBFDC607GS",
  "country": "ph"
}
```

### POST https://api.reefapi.com/zalora/v1/reviews — 1 credit
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.

**Parameters:**
- `config_sku` (string, required) — Zalora product handle: the `config_sku` from a search row (AE5AFACBFDC607GS), the product-page slug, or a full product URL (zalora.<tld>/p/<slug>) — all three resolve.
- `country` (enum, optional, default "ph") — Which Zalora country storefront to read. Catalogue, prices and currency differ per country; Taiwan is not served by Zalora any more and is not offered here. [one of: ph, sg, my, id, hk]
- `limit` (integer, optional, default 20) — Reviews per page (the source serves them in cursor pages).
- `cursor` (string, optional) — Opaque page cursor — pass back meta.next_cursor from the previous response to get the next page of reviews.

**Returns:** reviews[]{review_id, rating, text, author, created_at, tags[], images[]} + statistics{avg_rating, review_count, most_mentioned_tags[]} + meta{has_more, next_cursor, country}

**Example request body:**
```json
{
  "config_sku": "AE5AFACBFDC607GS",
  "country": "ph"
}
```

### POST https://api.reefapi.com/zalora/v1/categories — 1 credit
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.

**Parameters:**
- `country` (enum, optional, default "ph") — Which Zalora country storefront to read. Catalogue, prices and currency differ per country; Taiwan is not served by Zalora any more and is not offered here. [one of: ph, sg, my, id, hk]
- `segment` (enum, optional) — Return only the categories of one Zalora segment. Omit for the whole tree. [one of: women, men, kids, beauty, sports, luxury, home]

**Returns:** categories[]{category_id, name, segment, parent_id, url_key, image_url} + meta{total, country}

**Example request body:**
```json
{
  "country": "ph",
  "segment": "women"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=zalora
- Human docs page: https://reefapi.com/docs/zalora
- Overview page: https://reefapi.com/zalora-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
