List H&M product reviews
List an H&M product's reviews with ratings, fit, the colour and size bought, and the rating summary.
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}$
Order of the reviews: `newest` (default), `oldest`, `highest_rating` or `lowest_rating`.
one of: newest, oldest, highest_rating, lowest_rating
Reviews per page, 1 to 100. Default: 20.
≥ 1 · ≤ 100
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.
`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
The article id asked for.
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`.
Order used.
one of: newest, oldest, highest_rating, lowest_rating
Reviews across every page, every colour included.
Review statistics, on the first page only; null after it.
Average stars out of 5.
Ratings given.
Ratings that came with written reviews.
Ratings per star, 5 stars first.
Stars, 1 to 5.
Ratings with that many stars.
How reviewers say it fits, on average.
What was rated, e.g. `True to Size`.
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.
Reviews on this page.
Review id.
Stars, 1 to 5.
Review title.
Review text; null for a rating left without words.
When it was posted, ISO 8601 with H&M's offset.
When the reviewer bought it, ISO 8601.
Readers who found it helpful.
Readers who did not.
Whether the reviewer got something for the review.
Language and country of the review, e.g. `en_US`.
How the reviewer said it fits.
What was rated, e.g. `True to Size`.
The answer, e.g. `Runs Small`.
The colour and size the review was left on; reviews of every colour are listed together.
Size article number the review was left on.
Article id (colour) the review was left on.
Colour bought.
Size bought.
Product page URL.
URLs of photos attached.
Replies from H&M.
Response text.
When H&M responded, ISO 8601.
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/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.