H&M hub

H&M Categories API

The whole category menu of an H&M market, parents before their children.

GET /v1/hm/categories

1 credit Failed requests are free

About this endpoint

GET /v1/hm/categories returns data.categories[] and data.totalCount. A category carries id, name, parentId (null at the top), depth, path (names from the top down), url, groupTitle and highlighted. Categories come parents first, so a tree can be built in one pass. country and language pick the market; a market without an online store answers 400 and is not charged.

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 Categories API FAQ

How many categories does a market have?

Several hundred to over a thousand. The US menu lists about 1,300, from Women, Men, Kids and Home down to individual product types and campaigns.

How often does the menu change?

H&M adds and removes campaign entries every few days; the department structure changes rarely. Answers can be up to six hours old.

Can I search inside a category?

Not directly. Use the category's name as the query for GET /v1/hm/search, and the departments and filters on the answer to narrow it.

How much does the category list 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.