Hm APIwww2.hm.com ↗
Access H&M US and Korea product catalogs, search, category navigation, sale listings, new arrivals, recommendations, and store locations via a structured API.
What is the Hm API?
The H&M API covers 12 endpoints across the US and Korean storefronts, returning product listings, search results, full variant details, sale and new-arrival feeds, styling recommendations, and physical store locations. get_product_detail returns all color variants with stock states and image galleries for a given article code, while get_store_finder delivers US store coordinates and opening hours filterable by city.
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 Discovery and Search
search_products accepts a keyword query and returns up to 45 products per page, including productName, prices, swatches, sizes, availability, and filter facets. get_product_listing works against a category path (e.g. men/products/view-all) and returns up to 36 products per page with totalHits and full pagination metadata (currentPage, nextPageNum, totalPages). get_category_navigation returns the full site menu tree with nodeId, nodeName, href, and nested children for all departments — useful for building valid category paths to pass to listing endpoints.
Product Detail and Recommendations
get_product_detail accepts either an article_code or a full product URL and returns productName, brand, colorName, prices, swatches, images (with assetType), and a variations map covering every color variant with its own price and stockState. get_similar_items takes an article code and returns recommendationLists grouped by label — style_with, alternatives, and upsell — each containing a productList with pricing and availability.
Sale, New Arrivals, and Korean Storefront
get_sale_products scopes listings to sale sections (e.g. women/sale/view-all) and adds regularPrice, redPrice, and discountPercentage to each hit. get_new_arrivals follows the same structure scoped to new-arrival paths. The Korean storefront is covered by three dedicated endpoints — search_products_kr, list_products_kr, and get_product_details_kr — which return KRW prices (regular, current, and member), Korean product names, few_piece_left size-level flags, new_arrival booleans, and concept labels like H&M Premium Selection. get_related_products_kr mirrors get_similar_items for Korean products.
Store Locations
get_store_finder returns US H&M locations with name, city, address, coordinates, and openingHours. The optional city parameter does case-insensitive substring matching, so passing New York returns all stores in that city without requiring an exact match.
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-tracking tool that monitors
regularPriceandredPriceacrossget_sale_productsfor specific categories. - Sync H&M new arrivals into an internal merchandising dashboard using
get_new_arrivalswith a category path. - Power a size and stock availability checker using the
stockStateandsizesfields fromget_product_detailorget_product_details_kr. - Create a store locator feature using
get_store_findercoordinates andopeningHoursfor US locations. - Aggregate H&M Korean market pricing in KRW — including member prices — for cross-market retail analysis using
list_products_kr. - Generate complete-the-look outfit suggestions by consuming
recommendationListsfromget_similar_itemsorget_related_products_kr. - Index the full H&M category tree via
get_category_navigationto enumerate valid paths for downstream listing calls.
| 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 offer an official public developer API?+
What does `get_product_detail` return beyond basic pricing?+
get_product_detail returns a variations map keyed by variant article code, each entry containing color name, price, and stock state. It also includes an images array with typed assets (assetType values such as model or still-life shots) and a swatches array listing all available color options by articleId and colorName. You pass either an article_code or a full product URL.How does pagination work across listing endpoints?+
get_product_listing, search_products, get_sale_products, get_new_arrivals) all accept an integer page parameter (1-based) and return a pagination object with currentPage, nextPageNum, and totalPages. US category pages return up to 36 products per page; search returns up to 45. Korean endpoints also accept a page_size parameter for finer control.Does the API cover product reviews or ratings?+
Are markets outside the US and Korea covered?+
search_products_kr, list_products_kr, get_product_details_kr, get_related_products_kr) for the Korean site. Other regional H&M storefronts (EU, UK, etc.) are not currently covered. You can fork the API on Parse and revise it to point at additional regional domains.