H&M

List H&M categories

List every category in an H&M country's menu, with its parent, path and page URL.

GET/v1/hm/categories
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
countrystringquery

Two-letter country code of the H&M market, e.g. `GB` or `DE`. Default: `US`.

languagestringquery

Two-letter language code of the market's site, e.g. `en` or `fr`. Default: the market's main language.

pattern: ^[a-z]{2}$

Response fields
24

Endpoint-specific response payload.

datalookupStatus
string

`found`, or `not_found` when the market has no site.

one of: found, not_found

The H&M market the answer is for.

datamarketcountry
string

Two-letter country code, e.g. `US`.

datamarketlanguage
string

Two-letter language code, e.g. `en`.

datamarketlocale
string

H&M's own name for the market's site, e.g. `en_us`.

datamarketcurrency
stringnullable

ISO 4217 currency of the market, e.g. `USD`.

datatotalCount
integer

Categories listed.

Every category, parents before their children.

datacategories[]id
string

Category id, e.g. `ladies-women`.

datacategories[]name
string

Category name, e.g. `Women`.

datacategories[]parentId
stringnullable

Id of the category above; null at the top.

datacategories[]depth
integer

Depth in the tree, 0 at the top.

Names from the top down to this one.

datacategories[]path[]
stringoptional
datacategories[]url
stringnullable

Category page URL.

datacategories[]groupTitle
stringnullable

Heading the category sits under in the menu.

datacategories[]highlighted
booleannullable

Whether the menu highlights it.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.