H&M API endpoint
Returns one H&M category's product listing page: products with pricing, images, colors, and per-size stock. category_id is an H&M category slug (e.g. ladies_newarrivals_all, men_newarrivals_all, ladies_jeans) -- there is no category/nav-tree discovery endpoint, so category_id values come from known H&M storefront paths rather than a lookup call. Pagination is page-based and real: requesting a page beyond the category's real last page returns a normal response with an empty products array rather than an error.
/hm/listingcategory_id is required, an H&M category slug (e.g. ladies_newarrivals_all, men_newarrivals_all, ladies_jeans). This endpoint does not expose a category/nav-tree discovery call, so category_id values are currently sourced from known H&M storefront paths rather than a lookup call. page is optional, one-based, defaults to 1. page_size is optional, 1 to 72, defaults to 36. sort is optional and accepts RELEVANCE, NEWEST_FIRST, PRICE_ASCENDING, or PRICE_DESCENDING, defaults to RELEVANCE. is_new is an optional boolean filter for newly added items only.
Notable response behavior:
page returns identical results on repeat requests, and different pages return different, non-overlapping products.page beyond the category's real last page returns a normal 200 with an empty products array. total_pages and total_hits stay at their real, nonzero values in that case, distinguishing it from category_id pointing at an invalid or empty category, where both are genuinely 0.products[].id can carry a leading zero, so it is returned as a string, not a number.products[].colors[] lists every purchasable color for that product's own listing entry, each with its own image and product-page URL.products[].sizes[] lists every size H&M's listing offers for the displayed color, each with its own live stock count.| Field | Filled in, of 36 checked | Values in the sample |
|---|---|---|
| id | 36 | |
| name | 36 | “Harper High Rise Wide Leg Jeans” and 15 other values |
| brand | 36 | H&M in all 36 |
| url | 36 | www2.hm.com |
| image_url | 36 | image.hm.com |
| model_image_url | 36 | image.hm.com |
| price | 36 | 19.99 to 43.99, median 27.99 |
| formatted_price | 36 | “$27.99” and 13 other values |
| currency | 36 | USD in all 36 |
| availability | 36 | Available in all 36 |
| category_code | 36 | |
| colors | 36 | median 5 entries |
| sizes | 36 | median 11 entries |
| new_arrival | 5 | true in 5 of 5 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| category_id | string | Yes | H&M category slug | ladies_newarrivals_all | |
| page | integer | No | 1 | Page number, one-based, defaults to 1 | 1 |
| page_size | integer | No | 36 | Results per page, 1 to 72, defaults to 36 | 36 |
| sort | string | No | RELEVANCE | Sort order, defaults to RELEVANCE Allowed values: RELEVANCE, NEWEST_FIRST, PRICE_ASCENDING, PRICE_DESCENDING. | |
| is_new | boolean | No | Optional filter for newly added items only | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/hm/listing?category_id=ladies_newarrivals_all&page=1&sort=RELEVANCE&is_new=true" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"category_id": "ladies_jeans",
"page": 1,
"page_size": 2,
"sort": "RELEVANCE",
"total_pages": 195,
"total_hits": 585,
"count": 2,
"source_url": "https://api.hm.com/search-services/v1/en_us/listing/resultpage?categoryId=ladies_jeans...",
"fetched_at": "2026-08-10T06:00:00Z",
"products": [
{
"id": "1045459086",
"name": "Harper High Rise Wide Leg Jeans",
"brand": "H&M",
"url": "https://www2.hm.com/en_us/productpage.1045459086.html",
"image_url": "https://image.hm.com/assets/hm/d9/cb/d9cbd5615ab3ae695b2ffee69245ef11a800d424.jpg",
"price": 34.99,
"formatted_price": "$34.99",
"currency": "USD",
"availability": "Available",
"new_arrival": false,
"category_code": "ladies_jeans_wide",
"colors": [
{
"article_id": "1045459086",
"name": "Dark brown",
"color_code": "54443D",
"url": "https://www2.hm.com/en_us/productpage.1045459086.html",
"image_url": "https://image.hm.com/assets/hm/d9/cb/d9cbd5615ab3ae695b2ffee69245ef11a800d424.jpg"
}
],
"sizes": [
{
"id": "003",
"label": "4",
"stock": 2
}
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/hm.listingResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | hm.ListingResponse | No | ||||
| data.category_id | string | No | ||||
| data.count | integer | No | ||||
| data.fetched_at | string | No | ||||
| data.is_new | boolean | No | ||||
| data.page | integer | No | ||||
| data.page_size | integer | No | ||||
| data.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.sort | string | No | ||||
| data.source_url | string | No | ||||
| data.total_hits | integer | No | ||||
| data.total_pages | integer | 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/listing?category_id=ladies_newarrivals_all&page=1&sort=RELEVANCE&is_new=true" \
-H "x-api-key: $CRAWLORA_API_KEY"