H&M API endpoint
Returns every product-detail recommendation list H&M's own app shows for one product (which lists are present genuinely varies by product -- for example "more from series" and "style with" appear only when the product has one, while "alternatives" and "upsell" are more consistently present). An unrecognized product_id returns a well-formed empty result rather than an error.
/hm/product/{product_id}/relatedproduct_id is required, the numeric H&M product id from a listing/search result's id field.
Notable response behavior:
product-page-more_from_series, product-page-style_with, product-page-alternatives, product-page-upsell -- while a product without one (for example jeans, tested live) returns only product-page-alternatives and product-page-upsell.lists[].products[] uses the same product shape hm-listing/hm-search already establish (pricing, images, colors, per-size stock).product_id returns a well-formed empty lists array rather than an error.| Field | Filled in, of 2 checked | Values in the sample |
|---|---|---|
| label | 2 | “product-page-alternatives” and 1 other value |
| products | 2 | median 12 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| product_id (path) | string | Yes | Numeric H&M product id, from a listing/search result's id field | 1268470004 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/hm/product/1268470004/related" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"product_id": "1268470004",
"source_url": "https://api.hm.com/search-services/v1/en_us/recos/product-page?productKey=1268470004...",
"fetched_at": "2026-08-18T00:00:00Z",
"lists": [
{
"label": "product-page-alternatives",
"products": [
{
"id": "1351472002",
"name": "Knit Polo Shirt",
"brand": "H&M",
"url": "https://www2.hm.com/en_us/productpage.1351472002.html",
"image_url": "https://image.hm.com/assets/hm/aa/2f/aa2fdf2440fa3bb4ca4c494b8dbbec2549ce1ae8.jpg",
"price": 19.99,
"formatted_price": "$19.99",
"currency": "USD",
"availability": "Available"
}
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/hm.relatedResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | hm.RelatedResponse | No | ||||
| data.fetched_at | string | No | ||||
| data.lists | array | No | ||||
| data.lists[].label | string | No | ||||
| data.lists[].products | array | No | ProductSummary record, 23 fields: availability, brand, category_code, colors, coming_soon, currency, formatted_price, id, image_url, model_image_url, name, new_arrival and 3 more. Described under H&M Product Search API. | |||
| data.product_id | string | No | ||||
| data.source_url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/hm/product/1268470004/related" \
-H "x-api-key: $CRAWLORA_API_KEY"