H&M

List H&M product reviews

List an H&M product's reviews with ratings, fit, the colour and size bought, and the rating summary.

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

API key (`sfk_...`)

Parameters
6
idstringrequiredpath

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

pattern: ^\d{10}$

sortstringoptionalquery

Order of the reviews: `newest` (default), `oldest`, `highest_rating` or `lowest_rating`.

one of: newest, oldest, highest_rating, lowest_rating

limitintegeroptionalquery

Reviews per page, 1 to 100. Default: 20.

≥ 1 · ≤ 100

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
56

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when H&M has no product with this id in the market; a product with no reviews is `found` with an empty list.

one of: found, not_found

dataid
string

The article id asked for.

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

datasort
string

Order used.

one of: newest, oldest, highest_rating, lowest_rating

datatotalResults
integernullable

Reviews across every page, every colour included.

Review statistics, on the first page only; null after it.

datastatsaverageRating
numbernullable

Average stars out of 5.

datastatsratingCount
integernullable

Ratings given.

datastatsreviewCount
integernullable

Ratings that came with written reviews.

Ratings per star, 5 stars first.

datastatsratingDistribution[]rating
integer

Stars, 1 to 5.

datastatsratingDistribution[]count
integer

Ratings with that many stars.

How reviewers say it fits, on average.

datastatsfit[]name
string

What was rated, e.g. `True to Size`.

datastatsfit[]average
numbernullable

Average answer from 0 to 2 across the options, lowest first (e.g. Runs Small, True to Size, Runs Large).

The answers offered, lowest first.

datastatsfit[]options[]
stringoptional

Reviews on this page.

datareviews[]id
string

Review id.

datareviews[]rating
integernullable

Stars, 1 to 5.

datareviews[]title
stringnullable

Review title.

datareviews[]text
stringnullable

Review text; null for a rating left without words.

datareviews[]submittedAt
stringnullable

When it was posted, ISO 8601 with H&M's offset.

datareviews[]purchasedAt
stringnullable

When the reviewer bought it, ISO 8601.

datareviews[]helpfulCount
integernullable

Readers who found it helpful.

datareviews[]notHelpfulCount
integernullable

Readers who did not.

datareviews[]isIncentivized
booleannullable

Whether the reviewer got something for the review.

datareviews[]locale
stringnullable

Language and country of the review, e.g. `en_US`.

How the reviewer said it fits.

datareviews[]fit[]name
string

What was rated, e.g. `True to Size`.

datareviews[]fit[]value
stringnullable

The answer, e.g. `Runs Small`.

The colour and size the review was left on; reviews of every colour are listed together.

datareviews[]itemsku
stringnullable

Size article number the review was left on.

datareviews[]itemid
stringnullable

Article id (colour) the review was left on.

datareviews[]itemcolorName
stringnullable

Colour bought.

datareviews[]itemsize
stringnullable

Size bought.

datareviews[]itemurl
stringnullable

Product page URL.

URLs of photos attached.

datareviews[]photos[]
stringoptional

Replies from H&M.

datareviews[]brandResponses[]text
stringnullable

Response text.

datareviews[]brandResponses[]respondedAt
stringnullable

When H&M responded, ISO 8601.

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

Responses

A page of one H&M product's reviews, with its rating summary.