Uniqlo Scraper

Overview

The Uniqlo Scraper is a production-grade Apify actor designed to extract product listings from uniqlo.com search results and category pages.

This actor is built for stability, scalability, and ease of use, providing clean, structured output suitable for analytics, price monitoring, research, and downstream automation.

It supports keyword search, category browsing, sorting, pagination, and rate-limit handling.

---

Key Features

• 🔍 Keyword-based product search
• 🗂 Category page browsing
• ↕️ Multiple sorting modes (relevance, price, newest, top rated)
• 📦 Clean, simplified output schema
• 🔁 Automatic pagination
• 🛡 Built-in retry and rate-limit handling
• 🚀 Production-ready and Apify Store compliant

---

How It Works

1. The actor initializes with your keywords or the selected category.
2. Results are paginated automatically until the requested limit is reached.
3. Each item is simplified into a clean, user-friendly structure.
4. Data is stored in the default Apify dataset.

---

Input Configuration

Required Fields

Field	Type	Description
mode	string	Scraping mode: search or category

Optional Fields

Field	Type	Description
queries	array	List of search terms — used when mode = search (e.g. ["Shorts", "Shirts"])
category	string	Category to scrape — used when mode = category (see options below)
sortBy	string	Sorting mode (see options below)
maxItems	integer	Maximum number of products to scrape per query or category (min: 100, default: 200)

Sorting Options (sortBy)

• Relevance (default)
• New Arrivals
• Price low to high
• Price high to low
• Top Rated

Available Categories

Women

• T-Shirts & Sweats
• Shirts & Blouses
• Sweaters & Cardigans
• Bottoms ...

Men

• T-Shirts & Sweats
• Shirts
• Sweaters & Cardigans
• Pants ...

Kids

• T-Shirts, Sweats & Fleece
• Shirts & Blouses
• Jeans & Pants
• Dresses ...

Baby

• Newborn & Infant (0-24M)
• Toddler (6M-5Y) ...

---

Output Data Structure

The actor outputs a simplified, stable schema designed for analysts and automation pipelines.

Example Output

{
  "productId": "E470182-000",
  "name": "Flannel Shirt",
  "gender": "MEN",
  "price": {
    "currency": "USD",
    "symbol": "$",
    "base": 49.9,
    "promo": null,
    "isDualPrice": false
  },
  "rating": {
    "average": 4.8,
    "count": 53
  },
  "colors": [
    {
      "code": "COL69",
      "displayCode": "69",
      "name": "NAVY",
      "filterCode": "BLUE"
    },
    {
      "code": "COL01",
      "displayCode": "01",
      "name": "OFF WHITE",
      "filterCode": "WHITE"
    }
  ],
  "sizes": [
    { "code": "SMA001", "displayCode": "001", "name": "XXS" },
    { "code": "SMA002", "displayCode": "002", "name": "XS" },
    { "code": "SMA003", "displayCode": "003", "name": "S" },
    { "code": "SMA004", "displayCode": "004", "name": "M" }
  ],
  "images": {
    "main": {
      "69": {
        "url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/470182/item/usgoods_69_470182_3x4.jpg",
        "modelGender": "Men"
      },
      "01": {
        "url": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/470182/item/goods_01_470182_3x4.jpg",
        "modelGender": null
      }
    },
    "chips": {
      "69": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/470182/chip/goods_69_470182_chip.jpg",
      "01": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/470182/chip/goods_01_470182_chip.jpg"
    },
    "sub": [
      {
        "url": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/470182/sub/goods_470182_sub13_3x4.jpg",
        "videoUrl": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/470182/subvideo/usgoods_470182_sub13_video_3x4.mp4"
      }
    ]
  },
  "representativeColor": {
    "code": "COL69",
    "displayCode": "69",
    "name": "NAVY",
    "filterCode": "BLUE"
  },
  "inStock": true,
  "promotionText": null,
  "storeStockOnly": false
}

---

Use Cases

1. 📊 Price tracking and market analysis
2. 🛒 Product discovery and catalog building
3. 📈 Trend and inventory monitoring
4. 🤖 Feeding downstream automation pipelines
5. 🧠 Dataset creation and enrichment

---

Performance & Reliability

1. Automatic retries with exponential backoff
2. Graceful handling of rate limits (403 / 429)
3. Batched dataset writes for efficiency
4. Designed for long-running and large-scale jobs

---

Support & Maintenance

This actor is actively maintained and designed for production usage. For issues or feature requests, please use the Apify platform issue tracker.

---

Final Notes

This actor prioritizes:

1. Data clarity
2. Operational reliability
3. Professional usability

It is suitable for both individual users and enterprise-scale workflows.