H&M hub

H&M Product API

One H&M product in one colour, with every detail its product page shows.

GET /v1/hm/products/{id}

3 credits Failed requests are free

About this endpoint

GET /v1/hm/products/{id} returns data.product with id, productCode, title, url, vendor, category, description, price, compareAtPrice when on sale, availableForSale, soldInStores, colorName, colorCode, images[], sizes[] with sku, label, availability and availableForSale, colors[] for every colour with its own price, composition[] part by part, materials[], careInstructions[], attributes[] such as fit and length, audience, breadcrumbs[], styleWith[] article ids and rating.

id is the 10-digit article id from the product page URL, such as 1240531009; a product page URL is accepted too. country and language pick the market (default US), and prices are in its currency.

Price

From $4.05 per 1,000 requests

3 credits per request. Failed requests are free.

Scale pack
$4.92 / 1,000
Growth pack
$7.08 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

H&M Product API FAQ

What is an article id?

An H&M product in one colour. The product code, such as 1240531, is shared by every colour, and the article id adds the colour, such as 1240531009. Find it in the product page URL or as id on any product from GET /v1/hm/search. colors lists the article id of every other colour.

Does it show stock for each size?

Yes. Each entry in sizes has its own sku, the label as shown, availability such as InStock or OutOfStock, and availableForSale for the online store. Store stock is not included.

What if the product does not exist in the market?

The answer is lookupStatus not_found with product null. A product sold in one market may be missing from another, so check the country you asked for.

How much does a product lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.