List H&M categories
List every category in an H&M country's menu, with its parent, path and page URL.
Headers
Get your API keyAPI key (`sfk_...`)
Two-letter country code of the H&M market, e.g. `GB` or `DE`. Default: `US`.
Two-letter language code of the market's site, e.g. `en` or `fr`. Default: the market's main language.
pattern: ^[a-z]{2}$
Endpoint-specific response payload.
`found`, or `not_found` when the market has no site.
one of: found, not_found
The H&M market the answer is for.
Two-letter country code, e.g. `US`.
Two-letter language code, e.g. `en`.
H&M's own name for the market's site, e.g. `en_us`.
ISO 4217 currency of the market, e.g. `USD`.
Categories listed.
Every category, parents before their children.
Category id, e.g. `ladies-women`.
Category name, e.g. `Women`.
Id of the category above; null at the top.
Depth in the tree, 0 at the top.
Names from the top down to this one.
Category page URL.
Heading the category sits under in the menu.
Whether the menu highlights it.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/hm/categories?country=US" \
-H "x-api-key: YOUR_API_KEY"Responses
Every category in one H&M country's menu.