H&M hub

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/search

1 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.

Request
cURL

Example response

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

Request
JSON

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.