H&M

Get H&M product

Get an H&M product with its prices, sizes and online stock, every colour, images, materials, care and rating.

GET/v1/hm/products/{id}
3credits
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
idstringrequiredpath

The 10-digit article id from the product page URL, e.g. `1240531009`. A product page URL is accepted too.

pattern: ^\d{10}$

countrystringoptionalquery

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

languagestringoptionalquery

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
85

Endpoint-specific response payload.

datalookupStatus
string

`found`, or `not_found` when H&M has no product with this id in the market.

one of: found, not_found

dataid
string

The article id that was looked up.

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

The product; null when not found.

dataproductid
string

Article id, the product in this colour, e.g. `1240531009`.

dataproductproductCode
stringnullable

Product code shared by every colour, e.g. `1240531`.

dataproducttitle
string

Product name.

dataproducturl
stringnullable

Product page URL.

dataproductvendor
stringnullable

Brand, e.g. `H&M`.

dataproductproductType
stringnullable

H&M's category code, e.g. `men_hoodiessweatshirts_zipup`.

dataproductcategory
stringnullable

Category name, e.g. `Zip up Hoodies`.

dataproductdescription
stringnullable

Product description.

Current price; the sale price when the product is on sale.

dataproductpriceamount
numbernullable

The amount as a decimal number.

dataproductpricecurrency
stringnullable

ISO 4217 currency code, e.g. `USD`.

dataproductpriceformatted
stringnullable

The price as H&M shows it, e.g. `$29.99`.

Regular price when the product is on sale; null otherwise.

dataproductcompareAtPriceamount
numbernullable

The amount as a decimal number.

dataproductcompareAtPricecurrency
stringnullable

ISO 4217 currency code, e.g. `USD`.

dataproductcompareAtPriceformatted
stringnullable

The price as H&M shows it, e.g. `$29.99`.

dataproductavailableForSale
booleannullable

Whether at least one size can be bought online now; null where H&M doesn't say.

dataproductcomingSoon
booleannullable

Whether it is coming soon.

dataproductsoldInStores
booleannullable

Whether H&M sells this colour in its stores.

dataproductcolorName
stringnullable

Colour of this article.

dataproductcolorCode
stringnullable

Hex colour code of this article, e.g. `272627`.

dataproductfeaturedImage
stringnullable

Main product image URL.

Every image of this colour, in page order.

dataproductimages[]url
string

Image URL.

dataproductimages[]type
stringnullable

What the image shows, e.g. `Lookbook` or `DescriptiveStillLife`.

dataproductimages[]alt
stringnullable

The image's alt text as H&M writes it; null where it has none.

Sizes of this colour with their online stock.

dataproductsizes[]id
string

H&M's size code, e.g. `003`.

dataproductsizes[]sku
stringnullable

The size's own article number, e.g. `1240531009003`.

dataproductsizes[]label
stringnullable

Size as shown, e.g. `M` or `32`.

dataproductsizes[]availability
stringnullable

Online stock as H&M states it, e.g. `InStock` or `OutOfStock`; null where it doesn't say.

dataproductsizes[]availableForSale
booleannullable

Whether the size can be bought online now; null where H&M doesn't say.

Every colour of the product, this one included.

dataproductcolors[]id
string

Article id of the product in this colour; pass it to this endpoint.

dataproductcolors[]colorName
stringnullable

Colour name, e.g. `Black`.

dataproductcolors[]colorCode
stringnullable

Hex colour code, e.g. `272627`.

dataproductcolors[]url
stringnullable

Product page URL of this colour.

Current price; the sale price when this colour is on sale.

dataproductcolors[]priceamount
numbernullable

The amount as a decimal number.

dataproductcolors[]pricecurrency
stringnullable

ISO 4217 currency code, e.g. `USD`.

dataproductcolors[]priceformatted
stringnullable

The price as H&M shows it, e.g. `$29.99`.

Regular price when this colour is on sale; null otherwise.

dataproductcolors[]compareAtPriceamount
numbernullable

The amount as a decimal number.

dataproductcolors[]compareAtPricecurrency
stringnullable

ISO 4217 currency code, e.g. `USD`.

dataproductcolors[]compareAtPriceformatted
stringnullable

The price as H&M shows it, e.g. `$29.99`.

dataproductcolors[]featuredImage
stringnullable

Main image of this colour.

dataproductcolors[]comingSoon
booleannullable

Whether this colour is coming soon.

What the product is made of, part by part.

dataproductcomposition[]part
stringnullable

The part of the product, e.g. `Lining`; null when the whole product.

Materials of the part.

dataproductcomposition[]materials[]name
string

Material, e.g. `Cotton`.

dataproductcomposition[]materials[]percent
numbernullable

Share of the part, e.g. `60` for 60%.

The materials H&M explains for this product.

dataproductmaterials[]name
string

Material, e.g. `Recycled polyester`.

dataproductmaterials[]description
stringnullable

H&M's explanation of the material.

Care instructions, e.g. `Machine wash at 40°`.

dataproductcareInstructions[]
stringoptional

Product details as H&M lists them: fit, length, style and more.

dataproductattributes[]name
string

H&M's name for the detail, e.g. `fits`.

Its values, e.g. `Oversized`.

dataproductattributes[]values[]
stringoptional
dataproductaudience
stringnullable

Who it is for as H&M states it, e.g. `male` or `female`.

The product's place in H&M's menu, from the home page down.

dataproductbreadcrumbs[]label
string

Category name.

dataproductbreadcrumbs[]url
stringnullable

Category page URL.

Article ids H&M suggests wearing with it; pass one to this endpoint.

dataproductstyleWith[]
stringoptional

Customer ratings; null when the product has none.

dataproductratingaverage
numbernullable

Average stars out of 5.

dataproductratingcount
integernullable

Ratings given.

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/products/1240531009?country=US" \
  -H "x-api-key: YOUR_API_KEY"

Responses

One H&M product with its prices, sizes, colours and materials.