H&M API

H&M API for Product Search by Keyword or Category, Sale Prices, Colours and Sizes with Stock Level

Scrappa's H&M API returns structured JSON from H&M, the fashion retailer. Search products by keyword or category with sort and paging, filter by one facet such as colour or sale, and look up an article by id or product url for price, sale price, colours, sizes with stock level and images. Eight locales: US, Germany, UK, France, Sweden, India, Poland and Spain. It has no composition, description or reviews.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
2
Endpoints
8
Locales
From $0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Request preview
Request
curl -X GET "https://scrappa.co/api/hm/product?article_id=1331684001&locale=en_us" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response
{
  "success": true,
  "data": {
    "article_id": "1331684001",
    "name": "Denim Jeggings",
    "price": 5.99,
    "currency": "USD",
    "original_price": 12.99,
    "sale_price": 5.99,
    "discount_percent": 54,
    "sizes": [ { "label": "4-6M", "availability": "in_stock" }, { "label": "6-9M", "availability": "out_of_stock" } ]
  },
  "meta": { "endpoint_family": "product", "billable": true, "credits": 1 }
}

What you can build

Structured data for real applications. Here are some ideas.

Price Monitoring

Track price, original price, sale price and discount of any article over time, per locale and currency.

Size Availability

Read the stock level of every size of a colour: in stock or out of stock.

Assortment Analysis

Page through a keyword or category, sort by price or newest, and compare ranges across locales.

H&M scraper API

H&M API for prices, sale items and sizes with stock level

The H&M API is built for price monitoring, sale tracking and assortment analysis. Each article carries price, original price, sale price, colours, sizes with stock level and images. The article route finds one article by id or url. It has no composition, description, reviews or store stock. The data is public and needs no H&M login.

Eight locales through one locale parameter: en_us, de_de, en_gb, fr_fr, sv_se, en_in, pl_pl and es_es.

Paging is honest: a page is never labelled as another page, and a page past the end is rejected.

One filter per search, for example colour or sale. Other filter calls are rejected, not ignored.

Failed requests are never billed.

Choose the right H&M API endpoint

Use Search to find article ids

Search by keyword or category, then use the article id of a product in the article route.

Open H&M Search API docs

Use Article Lookup for one article

Pass an article id or url to get price, sale price, colours, sizes with stock level and images.

Open H&M Article Lookup API docs

Available endpoints

Everything you need in one API.

Key features

Search and article lookup routes as JSON
Numeric prices with currency, original price, sale price and discount
Colours with images and sizes with stock level
Keyword and category search with sort, paging and one filter
Eight locales, no browser, no login: public data served through a single Scrappa API key

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by H&M. The H&M API returns structured JSON from public product data through a Scrappa API key.

No. The article lookup uses the search data of H&M. It has price, colours, sizes with stock level and images, but no composition, description or reviews.

No. The sizes carry an online stock level, not a stock per store.

No. Only successful responses are billed.

Start using the H&M API

Sign up and get 500 free credits. No credit card required.