H&M Product Search API
Search one H&M market's catalogue by keyword and get priced products with colours, sizes and filters.
GET /v1/hm/search1 credit Failed requests are free
About this endpoint
GET /v1/hm/search returns data.products[], data.totalCount, data.filters[], data.departments[] and data.page. A product carries id (the 10-digit article id), productCode, title, url, vendor, productType, availableForSale, price, compareAtPrice when on sale, memberPrice, colorName, colorCode, swatches[] for every colour, sizes[] with a stockLevel, featuredImage, modelImage, images[] and markers[].
query is up to 200 characters. country and language pick the market (default US); sort takes relevance, newest, price_low or price_high; limit is 1 to 72 (default 36). Pass page.nextCursor as cursor for the next page.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 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 Search API FAQ
Which markets can I search?
Any H&M site that sells online, such as US, GB, DE, FR, SE and JP. A market without an online store answers 400 and is not charged. GET /v1/hm/countries lists every H&M country, with onlineStore saying which sell online.
How do sale prices show?
price is what the product costs now. On sale, compareAtPrice holds the regular price. Both carry amount, currency and formatted.
What is stockLevel on a size?
H&M's own stock indicator for that size: 0 when it is sold out, higher when it is in stock. It is an indicator, not a unit count.
Does a search with no match fail?
No. It answers lookupStatus found with an empty products list and totalCount 0.
Can I change the page size while paging?
The cursor keeps the page size it started with, so pages never overlap. Start again without a cursor to use another limit.
How much does a search page 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. Each paginated page is a separate billed request.