Get H&M product
Get an H&M product with its prices, sizes and online stock, every colour, images, materials, care and rating.
Headers
Get your API keyAPI key (`sfk_...`)
The 10-digit article id from the product page URL, e.g. `1240531009`. A product page URL is accepted too.
pattern: ^\d{10}$
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 H&M has no product with this id in the market.
one of: found, not_found
The article id that was looked up.
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`.
The product; null when not found.
Article id, the product in this colour, e.g. `1240531009`.
Product code shared by every colour, e.g. `1240531`.
Product name.
Product page URL.
Brand, e.g. `H&M`.
H&M's category code, e.g. `men_hoodiessweatshirts_zipup`.
Category name, e.g. `Zip up Hoodies`.
Product description.
Current price; the sale price when the product is on sale.
The amount as a decimal number.
ISO 4217 currency code, e.g. `USD`.
The price as H&M shows it, e.g. `$29.99`.
Regular price when the product is on sale; null otherwise.
The amount as a decimal number.
ISO 4217 currency code, e.g. `USD`.
The price as H&M shows it, e.g. `$29.99`.
Whether at least one size can be bought online now; null where H&M doesn't say.
Whether it is coming soon.
Whether H&M sells this colour in its stores.
Colour of this article.
Hex colour code of this article, e.g. `272627`.
Main product image URL.
Every image of this colour, in page order.
Image URL.
What the image shows, e.g. `Lookbook` or `DescriptiveStillLife`.
The image's alt text as H&M writes it; null where it has none.
Sizes of this colour with their online stock.
H&M's size code, e.g. `003`.
The size's own article number, e.g. `1240531009003`.
Size as shown, e.g. `M` or `32`.
Online stock as H&M states it, e.g. `InStock` or `OutOfStock`; null where it doesn't say.
Whether the size can be bought online now; null where H&M doesn't say.
Every colour of the product, this one included.
Article id of the product in this colour; pass it to this endpoint.
Colour name, e.g. `Black`.
Hex colour code, e.g. `272627`.
Product page URL of this colour.
Current price; the sale price when this colour is on sale.
The amount as a decimal number.
ISO 4217 currency code, e.g. `USD`.
The price as H&M shows it, e.g. `$29.99`.
Regular price when this colour is on sale; null otherwise.
The amount as a decimal number.
ISO 4217 currency code, e.g. `USD`.
The price as H&M shows it, e.g. `$29.99`.
Main image of this colour.
Whether this colour is coming soon.
What the product is made of, part by part.
The part of the product, e.g. `Lining`; null when the whole product.
Materials of the part.
Material, e.g. `Cotton`.
Share of the part, e.g. `60` for 60%.
The materials H&M explains for this product.
Material, e.g. `Recycled polyester`.
H&M's explanation of the material.
Care instructions, e.g. `Machine wash at 40°`.
Product details as H&M lists them: fit, length, style and more.
H&M's name for the detail, e.g. `fits`.
Its values, e.g. `Oversized`.
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.
Category name.
Category page URL.
Article ids H&M suggests wearing with it; pass one to this endpoint.
Customer ratings; null when the product has none.
Average stars out of 5.
Ratings given.
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/products/1240531009?country=US" \
-H "x-api-key: YOUR_API_KEY"Responses
One H&M product with its prices, sizes, colours and materials.