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.
Example response
A 200 response. Live responses have the same shape with current data.
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.