H&M Search Results Scraper

Overview

The H&M Search Results Scraper is a production-grade Apify actor designed to extract product listings from hm.com search results.

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

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

---

Key Features

• 🔍 Keyword-based product search
• ↕️ Multiple sorting modes (best match, newest, price)
• 📦 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.
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
keywords	string	Search keywords seperated by comma (e.g. jacket, jeans , boots)

Optional Fields

Field	Type	Description
Country	string	Get data for a specific country
sortBy	integer	Sorting mode
maxItems	integer	Maximum number of items to scrape

Sorting Options (sortBy)

RELEVANCE, NEWEST_FIRST, PRICE_ASCENDING, PRICE_DESCENDING

---

Output Data Structure

The actor outputs a simplified, stable schema designed for non-technical users and analysts.

Example Output

{
  "id": "1301478001",
  "title": "Jacket",
  "brand": "H&M",
  "price": 499.0,
  "formatted_price": "HK$499.00",
  "currency": "H",
  "url": "https://www2.hm.com/en_hk/productpage.1301478001.html",
  "availability": "Available",
  "coming_soon": false,
  "color": "Dark brown",
  "color_code": "3F3838",
  "category": "ladies_jacketscoats_jackets",
  "quality_marker": null,
  "new_arrival": false,
  "images": [
    "https://image.hm.com/assets/hm/c4/10/c410a9a013b10eb7fc743fd213596c3261458399.jpg",
    "https://image.hm.com/assets/hm/44/0b/440b977cb5ae4404e0ea084b4f46b9397255dc1f.jpg",
    "https://image.hm.com/assets/hm/16/60/16609aed879718477fbbc3ed0f92b5fe7385aaf7.jpg",
    "https://image.hm.com/assets/hm/fc/26/fc26e999295e9cc293e05d78ca00aefbf2675756.jpg"
  ],
  "model_image": "https://image.hm.com/assets/hm/0d/78/0d78f150f2e5ad657641217fc36aa8ebea52aa30.jpg",
  "swatches": [
    {
      "color": "Dark brown",
      "color_code": "3F3838",
      "image": "https://image.hm.com/assets/hm/e7/1e/e71e845409096ac552c229f656b092bce1eca5c1.jpg",
      "url": "https://www2.hm.com/en_hk/productpage.1301478001.html"
    }
  ],
  "sizes": [
    {
      "size": "XXS",
      "stock": 2,
      "in_stock": true
    },
    {
      "size": "XS",
      "stock": 2,
      "in_stock": true
    },
    {
      "size": "S",
      "stock": 2,
      "in_stock": true
    },
    {
      "size": "M",
      "stock": 2,
      "in_stock": true
    },
    {
      "size": "L",
      "stock": 2,
      "in_stock": true
    },
    {
      "size": "XL",
      "stock": 2,
      "in_stock": true
    }
  ]
}

Use Cases

1. 📊 Market research and price analysis

2. 🛒 Product discovery and comparison

3. 📈 Trend 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.