Uniqlo Product Scraper

Scrape UNIQLO.com — search products by keyword, browse by category, or fetch full detail for specific product IDs. Get prices, colors, sizes, ratings, images, descriptions, and category breadcrumbs straight from UNIQLO's public commerce API. No login, no cookies, no proxy required.

What this actor does

• Three modes: search (keyword), byCategory (taxonomy browse), byProductIds (exact product lookup with full description/composition/care info)
• Filters: category, color family, gender/age line, price range, minimum rating, on-sale-only, in-stock-only, product flag/badge (New, Coming Soon, Pre-order, ...), sort order
• Rich detail mode: long description, fabric composition, care instructions, design details, country of origin, size chart URL, customer rating breakdown
• Real customer reviews (optional, mode=byProductIds): review title/comment, star rating, fit rating, purchased size/color, reviewer demographics (gender, age range, height/weight range, shoe size, location)
• Empty fields are omitted

Output per product

Search / category browse records

• productId, name, genderName
• priceValue, promoPriceValue, discountPercentage, onSale, currencyCode, currencySymbol
• ratingAverage, ratingCount
• colorNames[], colorCount, sizeNames[], lengthName (fit-length variant for pants/shorts, e.g. "Short"/"Regular"/"Tall")
• colorHexCodes (map of color name → swatch hex, for solid colors only), representativeColorHex
• imageUrl, colorImageUrls[]
• flagNames[] (e.g. "Limited-Time Offer"), flagCodes[] (UNIQLO's internal badge codes), promotionText
• inStock (representative color/size currently purchasable), storeStockOnly (only available in physical stores, not online)
• sourceUrl
• recordType: "product", scrapedAt

Product-detail records (mode=byProductIds) — everything above, plus:

• categoryName, subcategoryName, breadcrumbClass, breadcrumbGender
• shortDescription, longDescription, composition, careInstruction, washingInformation, designDetail
• additionalInformation (e.g. color-nuance notes), promoConditionText (e.g. "Buy 2 for $14.90")
• countriesOfOrigin[], tagNames[], sizeChartUrl, subImageUrls[], relatedProductIds[] (other fits/washes of the same style UNIQLO cross-sells on the product page)
• ratingFit (1-5 average fit score), ratingBreakdown (star-count histogram: fiveStar…oneStar)
• inStockColorNames[] (colors with at least one currently purchasable size)
• inStockSizeNames[] (sizes with at least one currently purchasable color)
• isBestSeller
• reviews[] (only when includeReviews=true) — each entry: reviewId, rating, fitRating, title, comment, reviewerName, reviewerGender, reviewerLocation, reviewerAgeRange, reviewerHeightRange, reviewerWeightRange, reviewerShoeSize, purchasedSize, purchasedColorName, helpfulCount, isIncentivized, createdAt; reviewsFetched (count)

Input

Field	Type	Default	Description
mode	select	search	search / byCategory / byProductIds
searchQuery	string	jeans	Keyword (mode=search)
category	select	–	Product category (required for byCategory, optional refinement for search)
productIds	array	–	Product IDs, e.g. E482279-000 (mode=byProductIds)
gender	select	any	Women / Men / Kids / Baby / Unisex
colorGroup	select	–	Color family (White, Black, Blue, ...)
sizeName	select	–	Restrict results to a specific size (XS-3XL, waist inseams, shoe sizes, bra sizes, baby/kids ages)
sortBy	select	relevance	Relevance / Newest / Price asc / Price desc / Recommended / Popular
minPrice / maxPrice	int	–	Price range in USD
minRating	int	–	Minimum average customer rating (0–5)
onSaleOnly	bool	false	Only products currently discounted
inStockOnly	bool	false	Only products currently purchasable online
flagFilter	select	–	Only products carrying this UNIQLO badge (New, Coming Soon, Pre-order, Sale, Limited-Time Offer, Multibuy, New color, Select Colors/Sizes Only, Made with recycled materials, UNISEX)
lengthFilter	select	–	Only pants/shorts with this fit-length variant (Short / Regular / Tall)
includeReviews	bool	false	mode=byProductIds only — fetch real customer reviews per product
maxReviewsPerProduct	int	5	Most-recent reviews to fetch per product (0–25, UNIQLO API cap)
maxItems	int	30	Hard cap (1–1000)

Example: browse a category

{
  "mode": "byCategory",
  "category": "Jeans",
  "gender": "WOMEN",
  "sortBy": "priceLowToHigh",
  "maxItems": 40
}

Example: lookup exact products

{
  "mode": "byProductIds",
  "productIds": ["E482279-000", "E465760-000"]
}

Use cases

• Price monitoring — track UNIQLO pricing and promotions across categories
• Assortment analysis — see the full color/size range for a given item
• Trend research — compare "newest" vs "popular" sort to spot what's trending
• Competitive retail intelligence — benchmark fast-fashion pricing and ratings
• Product feed enrichment — pull rich descriptions, composition, and care data for cataloging

FAQ

Do I need a proxy or login? No — the actor calls UNIQLO's public commerce API directly with a standard browser user agent. No cookies, API key, or Apify proxy credit required.

Which country/locale does this cover? The US storefront (uniqlo.com/us/en). Prices are in USD.

What's the difference between search and byCategory? search matches a free-text keyword against product names/descriptions; byCategory browses UNIQLO's own category taxonomy (no keyword needed) and is closer to clicking through the site's navigation menus.

Why do some products show onSale: true? UNIQLO periodically runs limited-time promotions; when the current promo price is below the standard base price, the actor flags it, includes both prices, and computes discountPercentage (rounded % off the base price).

How do I find a product's ID? Every record includes productId and sourceUrl. You can also copy it from a UNIQLO product page URL: uniqlo.com/us/en/products/E482279-000/....

Are ratings available for every product? Only for products that have received customer reviews; ratingAverage/ratingCount are omitted otherwise (never emitted as 0/null).

How do I get customer review text? Set includeReviews: true with mode: byProductIds. Each detail record gets a reviews[] array with the review title, comment, star/fit rating, purchased size/color, and any reviewer demographics they shared (some are optional and omitted per-reviewer if not provided). Use maxReviewsPerProduct (0–25) to control how many are fetched per product.