Hm APIwww2.hm.com ↗
Access H&M US and Korea product catalog, search, category navigation, sale listings, product details, recommendations, and store locations via a structured API.
What is the Hm API?
The H&M API exposes 13 endpoints covering the H&M US and Korea storefronts, including product search, category navigation, sale and new-arrival listings, full product details, and size guides. The get_product_detail endpoint returns variant-level data including color swatches, stock states, image galleries, and price arrays — all by article code or product URL.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/b11138d2-5bc5-459f-8d49-36adf6448cff/get_category_navigation' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch the full site navigation tree including all departments and subcategories. Returns hierarchical menu structure with nodeId, nodeName, href, and nested children for Women, Men, Kids, Baby, and other departments.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array of category objects with nodeId, nodeName, href, children"
},
"sample": {
"data": {
"categories": [
{
"href": "/en_us/women.html",
"nodeId": "ladies-women",
"children": [
{
"href": "/en_us/women/new-arrivals.html",
"nodeId": "ladies-new-arrivals-0-women-new-arrivals",
"children": [],
"nodeName": "New in"
}
],
"nodeName": "Women"
}
]
},
"status": "success"
}
}About the Hm API
Product Catalog and Search
The search_products endpoint accepts a query string and returns up to 45 products per page with fields like productName, prices, swatches, sizes, and availability, plus a facets array for downstream filtering. The get_product_listing endpoint works against category paths such as men/products/view-all or kids/girls/products/view-all, returning up to 36 products per page with totalHits and full pagination metadata. For sale inventory, get_sale_products returns regularPrice, redPrice, and discountPercentage per product.
Product Details and Recommendations
get_product_detail accepts either an article_code or a full product URL and returns the complete variant map: a variations object keyed by article code, each with color, price, and availability details, plus an images array and swatches list. get_similar_items takes an article_code and returns recommendation lists labeled style_with, alternatives, and upsell, each containing related products with pricing.
Korean Storefront
A parallel set of endpoints — search_products_kr, list_products_kr, get_product_details_kr, and get_related_products_kr — covers the H&M Korea site. Products are returned with Korean names and KRW prices including regular, current, and member-tier prices. get_product_details_kr adds size-level online_available and few_piece_left flags, plus metadata fields like new_arrival, concept, collection, and section.
Size Guides and Store Locations
get_size_guide returns measurement tables (chest, waist, hip, inside leg in both inch and cm) with international size conversions for US, EUR, and KR systems. Supply an article_code and an optional locale to get the guide appropriate for a specific garment type. get_store_finder returns US store locations with name, address, geographic coordinates, and opening hours, and accepts an optional city substring filter.
The Hm API is a managed, monitored endpoint for www2.hm.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when www2.hm.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official www2.hm.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a price comparison tool by pulling
regularPriceandredPricefromget_sale_productsacross categories. - Populate a product feed for a fashion affiliate site using
search_productswith pagination across keyword queries. - Track stock availability changes for specific SKUs by polling
get_product_detailand diffing theavailability.stockStatefield. - Render a store locator map with coordinates and opening hours from
get_store_finder, filtered by city. - Surface complete-the-look recommendations in a shopping app using the
style_withlist fromget_similar_items. - Build a size recommendation feature using measurement tables and international conversions from
get_size_guide. - Monitor new seasonal drops by polling
get_new_arrivalsfor target category paths and tracking changes intotalHits.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does H&M have an official public developer API?+
What does `get_product_details_kr` return that the US `get_product_detail` does not?+
get_product_details_kr includes size-level online_available and few_piece_left boolean flags, a member_price field separate from the regular and current KRW prices, and product metadata fields like new_arrival, concept, collection, and section. The US endpoint does not expose member pricing or per-size online availability.Does the API cover product reviews or ratings?+
How does pagination work across listing endpoints?+
page parameters. The response always includes a pagination object with currentPage, nextPageNum, totalPages, and pageSize. When nextPageNum is null or equal to totalPages, you have reached the last page. Category listing pages return up to 36 products; search returns up to 45.Does the API cover H&M storefronts outside the US and Korea?+
_kr) and the Korean storefront (_kr endpoints). Other regional storefronts — such as the UK, Germany, or Sweden — are not covered. You can fork this API on Parse and revise it to target additional locale paths.