HM Product Search Actor

Overview

This actor searches and extracts product data from H&M's website. It provides programmatic access to H&M's product catalog through an API, returning structured JSON results suitable for developers and researchers.

Key Features

• Search H&M's product database with a query term.
• Handle pagination for large result sets.
• Configure items per page and target country/market.
• Built-in rate limiting and error handling.
• Easy integration into other applications and workflows.

Input Parameters

Configure the actor using these input fields:

• query (required): Your search term (e.g., "jacket").
• page (optional): The page number to start from. Default is 1.
• perPage (optional): Number of products to return per page. Default is 36.
• countryCode (optional): The market code for the H&M site (e.g., en_us). Default is en_us.

How to Use

Provide input via the Apify console or API. A basic configuration looks like this:

const input = {
  "query": "jacket",
  "page": "1",
  "perPage": "12",
  "countryCode": "en_us"
};

Run the actor with this input to fetch the first page of jacket products from the US English site.

Output Format

The actor returns a structured JSON object containing metadata and product listings.

Top-Level Structure:

{
  "requestDateTime": "2025-01-09T11:44:21.152Z",
  "pagination": {
    "currentPage": 1,
    "nextPageNum": 2,
    "totalPages": 37
  },
  "searchMeta": {
    "query": "jacket",
    "didYouMean": [],
    "relatedSearches": [],
    "blocked": false
  },
  "products": [ ... ]
}

Product Object (simplified example):
Each item in the products array contains detailed information:
* id, productName, brandName
* url: Link to the product page.
* prices: Array with redPrice (sale) and whitePrice (original).
* availability: Stock status.
* productImage and images: URLs for product photos.
* colorName, colors, and colourShades.
* iswatches: Array of available color variants for the product.

Use the pagination data to navigate through multiple pages of results.