H&M

Search H&M products

Search H&M products in a country, with prices, sale prices, colours, sizes, filters and cursor paging.

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

API key (`sfk_...`)

Parameters
6
querystringrequiredquery

What to search for, e.g. `jeans` or `linen shirt`.

min 1 chars · max 200 chars

sortstringoptionalquery

`relevance` (default), `newest` first, `price_low` (lowest price first) or `price_high`.

one of: relevance, newest, price_low, price_high

limitintegeroptionalquery

Products per page, 1 to 72. Default: 36.

≥ 1 · ≤ 72

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 512 chars

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
89

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: no match is an empty list.

one of: found, not_found

dataquery
string

The query that was searched.

datasort
string

The order of the results.

one of: relevance, newest, price_low, price_high

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
integernullable

Matching products.

datapageNumber
integer

This page's number, from 1.

datatotalPages
integernullable

Pages at this page size.

Products on this page.

dataproducts[]id
string

Article id, the product in one colour, e.g. `1337544001`.

dataproducts[]productCode
stringnullable

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

dataproducts[]title
string

Product name.

dataproducts[]url
stringnullable

Product page URL.

dataproducts[]vendor
stringnullable

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

dataproducts[]productType
stringnullable

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

dataproducts[]availableForSale
booleannullable

Whether the product can be bought online now.

dataproducts[]stockState
stringnullable

Stock state as H&M names it, e.g. `Available`.

dataproducts[]comingSoon
booleannullable

Whether it is coming soon.

dataproducts[]newArrival
booleannullable

Whether it is a new arrival.

dataproducts[]isOnline
booleannullable

Whether it is sold online.

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

dataproducts[]priceamount
numbernullable

The amount as a decimal number.

dataproducts[]pricecurrency
stringnullable

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

dataproducts[]priceformatted
stringnullable

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

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

dataproducts[]compareAtPriceamount
numbernullable

The amount as a decimal number.

dataproducts[]compareAtPricecurrency
stringnullable

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

dataproducts[]compareAtPriceformatted
stringnullable

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

Members' price where H&M offers one; null otherwise.

dataproducts[]memberPriceamount
numbernullable

The amount as a decimal number.

dataproducts[]memberPricecurrency
stringnullable

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

dataproducts[]memberPriceformatted
stringnullable

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

dataproducts[]discountPercent
numbernullable

The sale discount H&M shows, e.g. `60` for `-60%`; null when the product is not on sale.

≥ 0

dataproducts[]colorName
stringnullable

Colour of this article.

dataproducts[]colorCode
stringnullable

Hex colour code of this article.

Colour shades H&M tags the article with.

dataproducts[]colorShades[]
stringoptional
dataproducts[]featuredImage
stringnullable

Main product image URL.

dataproducts[]featuredImageAlt
stringnullable

The main image's alt text; null where it has none.

dataproducts[]modelImage
stringnullable

Image of the product worn.

Every image in the result.

dataproducts[]images[]url
string

Image URL.

dataproducts[]images[]type
stringnullable

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

dataproducts[]images[]alt
stringnullable

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

Every colour of the product, this one included.

dataproducts[]swatches[]id
string

Article id of this colour.

dataproducts[]swatches[]colorName
stringnullable

Colour name, e.g. `Light beige`.

dataproducts[]swatches[]colorCode
stringnullable

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

dataproducts[]swatches[]url
stringnullable

Product page URL of this colour.

dataproducts[]swatches[]image
stringnullable

Product image of this colour.

Sizes with their stock indicator.

dataproducts[]sizes[]id
string

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

dataproducts[]sizes[]label
stringnullable

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

dataproducts[]sizes[]stockLevel
integernullable

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

dataproducts[]markers[]
stringoptional
dataproducts[]hasVideo
booleannullable

Whether the product has a video.

dataproducts[]isMultipack
booleannullable

Whether it is a multipack.

Filters with counts.

datafilters[]id
string

Filter id, e.g. `colorWithNames`.

datafilters[]name
stringnullable

Filter name, e.g. `Colors`.

datafilters[]type
stringnullable

`TEXT`, `RANGE` and the like.

Values with counts.

datafilters[]values[]id
string

Value id.

datafilters[]values[]name
string

Value name.

datafilters[]values[]count
integernullable

Matching products.

datafilters[]min
numbernullable

Lowest value of a range filter.

datafilters[]max
numbernullable

Highest value of a range filter.

Departments with counts.

datadepartments[]id
string

Department id, e.g. `ladies_all`.

datadepartments[]label
stringnullable

Department name, e.g. `Women`.

datadepartments[]count
integernullable

Matching products.

Spelling suggestions.

datadidYouMean[]
stringoptional

Related searches.

datarelatedSearches[]
stringoptional

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

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/search?query=jeans" \
  -H "x-api-key: YOUR_API_KEY"

Responses

H&M products matching the search, with filters.