H&M APIwww2.hm.com ↗
Access H&M US product catalog, search, category navigation, sale listings, new arrivals, similar items, and store locations via a structured REST API.
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 H&M API
The H&M API covers 8 endpoints that expose H&M's US product catalog, including search, category navigation, sale and new-arrival listings, and physical store locations. The get_product_detail endpoint returns per-variant pricing, color swatches, availability states, and image arrays for any article code. Whether you're tracking prices, building a product feed, or mapping store locations, the API surfaces the structured data H&M displays to shoppers.
Product Catalog and Search
The search_products endpoint accepts a query string and returns matching hits with title, articleCode, prices, and images, along with facets for filtering and full pagination metadata (currentPage, totalPages, pageSize). For browsing by category, get_product_listing takes a category path such as men/products/view-all and optional page and sort parameters, returning totalHits and a hits array that includes swatches and sizes.
Product Detail and Recommendations
get_product_detail accepts either an article_code or a full product url. The response includes productName, brand, prices (each with priceType, price, and formattedPrice), an images array, swatches with colorName and articleId, a variations map keyed by variant article code, and an availability object reflecting stock state. To find related products, get_similar_items takes an article_code and returns recommendationLists, each containing a productList of similar items.
Sale, New Arrivals, and Navigation
get_sale_products accepts an optional category path such as women/sale/view-all and returns hits that include both regularPrice and redPrice along with discountPercentage. get_new_arrivals works the same way for recently added items. get_category_navigation requires no inputs and returns the full department tree — Women, Men, Kids, Baby, and more — as nested objects with nodeId, nodeName, href, and children.
Store Finder
get_store_finder returns US H&M store locations. The optional city parameter filters results by case-insensitive substring match (e.g. New York). Each store record includes name, address, coordinates, city, and openingHours. The total field indicates how many stores matched.
- Monitor price changes on specific article codes using
get_product_detailpricesandavailabilityfields. - Build a sale aggregator that tracks
regularPrice,redPrice, anddiscountPercentageacross categories viaget_sale_products. - Populate a product feed with images, swatches, and variant details from
get_product_detailvariations. - Drive keyword-based product discovery using
search_productsfacetsandtotalHitsfor result volume signals. - Map H&M store locations and display hours using
get_store_findercoordinatesandopeningHours. - Track new-season drops by polling
get_new_arrivalswith specific department category paths. - Build a 'you may also like' feature using article codes from
get_similar_itemsrecommendationLists.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. 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_detail` return beyond the product name and price?+
get_product_detail returns an images array, swatches (each with articleId and colorName), a variations object keyed by variant article code that includes per-variant color, price, and availability, and an availability object with stock state. You can look up a product by article_code or by passing the full product url.Does the API cover H&M markets outside the United States?+
Does the API return customer reviews or ratings for products?+
How does pagination work across listing endpoints?+
get_product_listing, search_products, get_sale_products, and get_new_arrivals — all accept an integer page parameter and return a pagination object containing currentPage, totalPages, pageSize, and (where applicable) nextPageNum. totalHits tells you the total number of matching products across all pages.