# H\&M Product Scraper US (`mrdoe/hm-product-scraper-us`) Actor

Extract product data from H\&M US, including product names, prices, availability, colors, sizes, product URLs, and images. Scrape specific categories or product listings efficiently for fashion research, price monitoring, and e-commerce data collection.

- **URL**: https://apify.com/mrdoe/hm-product-scraper-us.md
- **Developed by:** [MrDoe](https://apify.com/mrdoe) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

**Turn H\&M's product catalog into structured data in minutes** - no coding, no manual copy-pasting. Get product name, price, sizes with live stock, colors, and photos for any H\&M category, paged through automatically.

### What does H\&M Product Scraper US do?

H\&M Product Scraper US collects fashion product listings from [HM.com](https://www2.hm.com) (US). Point it at any category page URL and it pages through the results automatically, extracting every product it finds along with size availability, color options, pricing, and photos.

### Why use H\&M Product Scraper US?

- **Price monitoring** - track how H\&M prices specific categories or products over time, including member/club pricing and sale discounts.
- **Stock tracking** - see which sizes are actually in stock for any product, not just whether the product page loads.
- **Trend and assortment research** - see exactly what's in a category, in which colors, with what marketing callouts (e.g. "Premium Selection").
- **Data enrichment** - pull structured product data into your own spreadsheet, PIM, or price-comparison tool.

### How to use H\&M Product Scraper US

1. Go to the **Input** tab.
2. Set **Start URL** to any H\&M category page (copy it straight from your browser), e.g. `https://www2.hm.com/en_us/women/new-arrivals/view-all.html`.
3. Set **Max items** and **Max pages** to control how much to collect.
4. Click **Start** and wait for the run to finish.
5. Open the **Dataset** tab to preview, filter, and export your results.

### Input

| Field | Type | Description |
| --- | --- | --- |
| `startUrl` | String | An HM.com category page URL. |
| `maxItems` | Integer | Maximum number of products to scrape (default: 100). |
| `maxPages` | Integer | Safety cap on how many pages to page through (default: 10). |
| `proxyConfiguration` | Object | Proxy settings. Residential proxies are required - HM.com blocks a meaningful share of non-residential sessions with a bot-protection challenge. |

Example input:

```json
{
    "startUrl": "https://www2.hm.com/en_us/women/new-arrivals/view-all.html",
    "maxItems": 100
}
```

### Output

Each product is saved as one item in the dataset, for example:

```json
{
    "articleCode": "1353218002",
    "url": "https://www2.hm.com/en_us/productpage.1353218002.html",
    "name": "Wool-Blend Pocket-Detail Cardigan",
    "brand": "H&M",
    "category": "ladies_cardigans",
    "price": 89.99,
    "currency": "USD",
    "regularPrice": "$89.99",
    "isDiscounted": false,
    "discountPercentage": null,
    "clubPriceLabel": "Member price",
    "marketingMarkerText": "H&M Premium Selection",
    "isComingSoon": false,
    "colorName": "Cream",
    "availableColors": ["Cream"],
    "sizes": [
        { "name": "XS", "inStock": true },
        { "name": "S", "inStock": true },
        { "name": "M", "inStock": true },
        { "name": "L", "inStock": true }
    ],
    "image": "https://image.hm.com/assets/hm/...jpg",
    "galleryImages": ["https://image.hm.com/assets/hm/...jpg"],
    "scrapedAt": "2026-08-14T00:00:00.000Z"
}
```

#### Data table

| Field | Description |
| --- | --- |
| `articleCode` | H\&M's internal product ID |
| `url` | The product's own page on HM.com |
| `name`, `brand`, `category` | Product identification |
| `price`, `currency`, `regularPrice` | Current price, currency, and the pre-discount price as H\&M displays it |
| `isDiscounted`, `discountPercentage` | Whether the item is on sale, and by how much |
| `clubPriceLabel` | Member-pricing label, where applicable |
| `marketingMarkerText` | Promotional badge text (e.g. "H\&M Premium Selection"), where shown |
| `isComingSoon` | Whether the product is listed as not yet available |
| `colorName`, `availableColors` | The color shown for this listing, and every color it's offered in |
| `sizes` | Every size H\&M lists, each with live `inStock` status |
| `image`, `galleryImages` | Primary photo and the full photo set for this listing |
| `scrapedAt` | ISO timestamp when the item was scraped |

H\&M doesn't expose ratings/reviews on its category listing pages - only individual product pages do, which would require a separate request per product. This Actor is built for fast, whole-category scraping, so review data isn't included; ask if you need a detail-page variant that trades speed for that.

### Pricing / Cost estimation

How much does it cost to scrape H\&M products? Pricing depends on your Apify plan's compute unit rate, residential proxy usage, and how many products you request. H\&M requires a real browser session to get past its bot-protection challenge, which costs more per page than a plain HTTP request.

### Tips for better runs

- Copy category URLs directly from your browser's address bar for the most reliable results.
- Keep **Max items**/**Max pages** modest for daily monitoring runs to control cost and run time.
- If a run finds zero results, it's most likely HM.com's bot-protection challenge blocking that particular proxy session - the Actor automatically retries with a fresh session up to 4 times before giving up.
- Use the Apify **Schedule** feature to re-run this Actor periodically and track price or stock changes over time.

### FAQ

**Is this legal?** This Actor only collects publicly visible product data. You are responsible for using the data in accordance with H\&M's Terms of Service and any applicable laws in your jurisdiction.

**Why did some fields come back empty?** Not every product has every field (e.g. not every item is on sale or has a marketing badge). The Actor returns `null` for anything that isn't available for a given product.

**Found a bug or have a feature request?** Please use the Issues tab on this Actor's page - feedback directly shapes future updates.

# Actor input Schema

## `startUrl` (type: `string`):

An HM.com category page URL, e.g. <code>https://www2.hm.com/en\_us/women/new-arrivals/view-all.html</code>. Copy any category URL from the site.

## `maxItems` (type: `integer`):

Maximum number of products to scrape, paging through the results until this limit or Max pages is reached.

## `maxPages` (type: `integer`):

Safety cap on how many pages of results to page through.

## `proxyConfiguration` (type: `object`):

HM.com blocks a meaningful share of non-residential sessions with a bot-protection challenge, so Apify Proxy with residential IPs is required.

## Actor input object example

```json
{
  "startUrl": "https://www2.hm.com/en_us/women/new-arrivals/view-all.html",
  "maxItems": 100,
  "maxPages": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `listings` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrl": "https://www2.hm.com/en_us/women/new-arrivals/view-all.html",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("mrdoe/hm-product-scraper-us").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrl": "https://www2.hm.com/en_us/women/new-arrivals/view-all.html",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("mrdoe/hm-product-scraper-us").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrl": "https://www2.hm.com/en_us/women/new-arrivals/view-all.html",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call mrdoe/hm-product-scraper-us --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,mrdoe/hm-product-scraper-us"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/dFOLqslFHWxbZQyl8/builds/ePXYu5bE7w7pysXmf/openapi.json