Ounass Scraper

Scrape Ounass — the leading luxury fashion, beauty, and lifestyle e-commerce platform for the UAE and GCC (Saudi Arabia, Oman, Kuwait, Bahrain, Qatar). Search products by keyword, browse categories across Women / Men / Kids, filter by designer, price, colour, and sale status, or pull full product detail pages (description, sizes, live stock, images) from product URLs.

What this actor does

• Three modes: search, byCategory, byProductUrls
• Six markets: UAE, Saudi Arabia, Oman, Kuwait, Bahrain, Qatar — prices and currency follow the selected market
• Two languages: English and Arabic — Arabic uses each market's own Arabic-language domain (e.g. ar.ounass.ae); product/designer/colour names come back in Arabic with the English equivalents still populated where the site provides them
• Three departments: Women, Men, Kids
• Nine categories, plus optional sub-category: Clothing, Bags, Shoes, Jewellery, Accessories, Beauty, Sale/Clearance, New In, Pre-Loved — with an optional free-text subCategory (e.g. dresses, handbags, sneakers) for deeper browsing
• Filters: designer/brand, colour, size, min/max price, minimum discount percent, on-sale-only, in-stock-only, sort order
• Full product detail mode: description, breadcrumb category path, all product images, per-size stock, loyalty points, return eligibility
• Empty fields are omitted — every record only contains data that was actually found

Output per product

Listing records (search / byCategory, recordType: "product")

• productId, sku
• productName, productNameEnglish (when different from productName)
• designer, designerEnglish (when different)
• color, division, department, productClass, productSubClass, gender, season
• price, originalPrice, discountPercent, currency
• inStock, isClearance, isPromotion, wishlistCount, badge
• thumbnailUrl, hoverImageUrl
• categoryPath, productUrl, sourceUrl
• sizes[] — sizeCode, sku, price, originalPrice, discountPercent, stock, inStock
• recordType: "product", scrapedAt

Product detail records (byProductUrls, recordType: "productDetail")

Everything above, plus:

• description — full product description text
• countryOfOrigin
• loyaltyPoints, isReturnable
• breadcrumbs[] — category path names from department down to product
• imageUrls[] — every product image, full resolution

Input

Field	Type	Default	Description
mode	select	search	search / byCategory / byProductUrls
searchQuery	string	dress	Free-text query (mode=search)
country	select	ae	Market: ae / sa / om / kw / bh / qa
language	select	en	en / ar — Arabic uses each market's Arabic-language domain
department	select	women	women / men / kids (mode=search, byCategory)
category	select	–	Category to browse (mode=byCategory), required for that mode
subCategory	string	–	Optional deeper listing under category, e.g. dresses, handbags, sneakers (mode=byCategory)
productUrls	array	–	Full Ounass product URLs (mode=byProductUrls)
designer	string	–	Only keep products whose designer contains this text
color	string	–	Only keep products whose colour contains this text
size	string	–	Only keep products offering a matching size, e.g. M, 42, One Size
minPrice	int	–	Minimum price in the selected market's currency
maxPrice	int	–	Maximum price in the selected market's currency
minDiscountPercent	select	–	Only keep products discounted by at least this percent: 10–80
sortBy	select	popularity	popularity / newness / mostWishlisted / lowestPrice / highestPrice
onSaleOnly	bool	false	Only keep clearance/promotion/discounted products
inStockOnly	bool	false	Only keep in-stock products
maxItems	int	50	Hard cap (1–2000)

Example: search for dresses under AED 3,000

{
  "mode": "search",
  "searchQuery": "dress",
  "department": "women",
  "maxPrice": 3000,
  "maxItems": 50
}

Example: browse men's shoes on sale, sorted by newest

{
  "mode": "byCategory",
  "department": "men",
  "category": "shoes",
  "onSaleOnly": true,
  "sortBy": "newness",
  "maxItems": 50
}

Example: full product details from a saved list of URLs

{
  "mode": "byProductUrls",
  "productUrls": [
    "https://www.ounass.ae/shop-mach-mach-peony-mini-dress-in-crochet-for-women-219308301_2709.html"
  ]
}

Example: browse a sub-category with size and discount filters

{
  "mode": "byCategory",
  "department": "women",
  "category": "clothing",
  "subCategory": "dresses",
  "size": "M",
  "minDiscountPercent": "30",
  "maxItems": 50
}

Example: Saudi Arabia market, designer filter

{
  "mode": "search",
  "searchQuery": "bag",
  "country": "sa",
  "designer": "Gucci",
  "maxItems": 30
}

Use cases

• Price monitoring — track designer/product prices and discounts across GCC markets
• Market research — compare product assortment and pricing between UAE, Saudi Arabia, and other GCC storefronts
• Trend tracking — sort by newness or wishlist count to spot trending designers/products
• Catalogue enrichment — pull full product descriptions, images, and size availability for a known list of product URLs

FAQ

Does this need a login or API key? No. All data is publicly available on Ounass's storefront pages.

Which markets are supported? United Arab Emirates, Saudi Arabia, Oman, Kuwait, Bahrain, and Qatar. Prices and currency automatically follow the selected market.

Can I get Arabic-language product data? Yes — set language: "ar". The run scrapes each market's Arabic-language storefront domain (e.g. ar.ounass.ae for UAE), so productName, designer, and color come back in Arabic. The English equivalents remain available in productNameEnglish / designerEnglish when the site provides them.

What sub-categories are available? subCategory is free text so it works with any of Ounass's own deeper listing slugs — for example, under clothing: dresses, tops, pants, jeans, knitwear, jumpsuits, abayas; under bags: handbags, backpacks, clutches; under shoes: sneakers, heels, sandals, boots. Spaces are converted to hyphens automatically. If a combination doesn't exist upstream, the run finishes cleanly with a status message instead of erroring.

Why do some department + category combinations return 0 results? Not every category exists under every department upstream (e.g. Jewellery and Beauty are primarily under Women). The run finishes cleanly with a status message rather than erroring.

Can I get full product descriptions and all images? Yes — use mode: "byProductUrls" with a list of product page URLs (from a prior search/byCategory run's productUrl field, or your own list).

How current is the data? Every run fetches live pages directly from Ounass — prices, stock, and discounts reflect what's on the site at run time.

Why does search combined with designer/minPrice/maxPrice sometimes return fewer results than byCategory with the same filters? Ounass's search backend only returns its first page of results when a text query is combined with a designer or price-range filter (pagination/sort parameters are ignored upstream in that combination) — our filters are still applied correctly client-side against that page. For deep, fully-paginated filtered browsing, use mode: "byCategory" with the same filters instead of mode: "search".

Does search work in Arabic? Ounass's own search index matches against its (English) product catalogue text, so Arabic-script queries currently return 0 results upstream — this is a source-side limitation, not an actor bug. Use English keywords, designer names, or product terms for best results.

Will productUrl open for me? Yes — every productUrl is a real, live Ounass page (verified 200 OK). Ounass runs Cloudflare bot-management on its storefront, so a bare curl/script request without a real browser TLS fingerprint may see a challenge page; opening the same URL in any normal web browser always works.