Search H&M products
Search H&M products in a country, with prices, sale prices, colours, sizes, filters and cursor paging.
Headers
Get your API keyAPI key (`sfk_...`)
What to search for, e.g. `jeans` or `linen shirt`.
min 1 chars · max 200 chars
`relevance` (default), `newest` first, `price_low` (lowest price first) or `price_high`.
one of: relevance, newest, price_low, price_high
Products per page, 1 to 72. Default: 36.
≥ 1 · ≤ 72
Pass `page.nextCursor` from the previous response to get the next page.
min 1 chars · max 512 chars
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.
Always `found`: no match is an empty list.
one of: found, not_found
The query that was searched.
The order of the results.
one of: relevance, newest, price_low, price_high
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`.
Matching products.
This page's number, from 1.
Pages at this page size.
Products on this page.
Article id, the product in one colour, e.g. `1337544001`.
Product code shared by every colour, e.g. `1337544`.
Product name.
Product page URL.
Brand, e.g. `H&M`.
H&M's category code, e.g. `ladies_jeans_wide`.
Whether the product can be bought online now.
Stock state as H&M names it, e.g. `Available`.
Whether it is coming soon.
Whether it is a new arrival.
Whether it is sold online.
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`.
Members' price where H&M offers one; 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`.
The sale discount H&M shows, e.g. `60` for `-60%`; null when the product is not on sale.
≥ 0
Colour of this article.
Hex colour code of this article.
Colour shades H&M tags the article with.
Main product image URL.
The main image's alt text; null where it has none.
Image of the product worn.
Every image in the result.
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.
Every colour of the product, this one included.
Article id of this colour.
Colour name, e.g. `Light beige`.
Hex colour code, e.g. `EAE5D6`.
Product page URL of this colour.
Product image of this colour.
Sizes with their stock indicator.
H&M's size code, e.g. `003`.
Size as shown, e.g. `S` or `32`.
H&M's stock indicator for the size: 0 when sold out, higher when in stock.
Labels on the product, e.g. `H&M Studio` or `New arrival`.
Whether the product has a video.
Whether it is a multipack.
Filters with counts.
Filter id, e.g. `colorWithNames`.
Filter name, e.g. `Colors`.
`TEXT`, `RANGE` and the like.
Values with counts.
Value id.
Value name.
Matching products.
Lowest value of a range filter.
Highest value of a range filter.
Departments with counts.
Department id, e.g. `ladies_all`.
Department name, e.g. `Women`.
Matching products.
Spelling suggestions.
Related searches.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
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/search?query=jeans" \
-H "x-api-key: YOUR_API_KEY"Responses
H&M products matching the search, with filters.