# H&M API: Get product > Gets an H&M item's current country-specific price, sizes, colours and images by product name or product page link. Description, materials, composition, care and sustainability details are always returned as null. Unofficial. Not affiliated with or endorsed by H&M. - Page: https://fous.com/methods/hm.com/get-product - Method: `hm.com/get_product`, version 1 - Website: hm.com - Returns: product name, colour, price, sale price, currency, sizes with online stock, colours, images, product link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `colour` | string | no | | Colour name to select, such as Beige. Defaults to the first colour. | | `country` | string | no | | Country name or two-letter code, such as United States or GB. Default "United States". | | `product` | string | yes | `"Regular-Fit Embroidered Resort Shirt"` | Product name or H&M product page link, such as Regular Fit Linen Shirt. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "product": "Regular-Fit Embroidered Resort Shirt" } ``` Its output: ```json { "fit": "Regular Fit", "price": 49.99, "sizes": [ { "in_stock": false, "low_stock": false, "size_label": "XS" }, { "in_stock": false, "low_stock": false, "size_label": "S" }, { "in_stock": false, "low_stock": false, "size_label": "M" } ], "colour": "Light yellow/patterned", "colours": [ { "link": "https://www2.hm.com/en_us/productpage.1348853001.html", "name": "Light yellow/patterned" } ], "materials": null, "sale_price": 29.99, "composition": null, "description": null, "image_links": [ "https://image.hm.com/assets/hm/91/01/91011a104dbdbae8ed131e61ac912e66dd8367f5.jpg", "https://image.hm.com/assets/hm/b9/6d/b96daeb7bb3d95a395105786404443a18d08c8e7.jpg", "https://image.hm.com/assets/hm/86/07/86076efbd72dfa73741f6c6c94ee0b48ab784b7d.jpg" ], "product_link": "https://www2.hm.com/en_us/productpage.1348853001.html", "product_name": "Regular-Fit Embroidered Resort Shirt", "currency_code": "USD", "article_number": "1348853001", "care_instructions": null, "sustainability_info": null } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"hm.com/get_product","input":{"product":"Regular-Fit Embroidered Resort Shirt"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What's the current price in the United States for the Regular Fit Linen Shirt in beige, and which sizes are in stock online? - Look up the H&M product page at https://www.hm.com/en_us/productpage.0123456789.html and tell me its price in GB pounds, available colours and images. - Can you check whether the Oversized Cotton Hoodie is available in size M and L online, and what it costs in Germany? - Find the sale price, currency and product link for the Slim Fit Chino Trousers in navy, shipping to Canada. - I want the Ribbed Knit Cardigan details, including the price and stock by size, for the French store in colour black. ## Input schema ```json { "type": "object", "required": [ "product" ], "properties": { "colour": { "type": "string", "description": "Colour name to select, such as Beige. Defaults to the first colour." }, "country": { "type": "string", "default": "United States", "description": "Country name or two-letter code, such as United States or GB." }, "product": { "type": "string", "description": "Product name or H&M product page link, such as Regular Fit Linen Shirt." } } } ``` ## Output schema ```json { "type": "object", "required": [ "product_name", "colour", "price", "currency_code", "sale_price", "sizes", "colours", "description", "materials", "composition", "care_instructions", "fit", "sustainability_info", "image_links", "product_link", "article_number" ], "properties": { "fit": { "type": [ "string", "null" ] }, "price": { "type": "number" }, "sizes": { "type": "array", "items": { "type": "object", "properties": { "in_stock": { "type": "boolean" }, "low_stock": { "type": [ "boolean", "null" ] }, "size_label": { "type": "string" } } } }, "colour": { "type": [ "string", "null" ] }, "colours": { "type": "array", "items": { "type": "object", "properties": { "link": { "type": "string" }, "name": { "type": "string" } } } }, "materials": { "type": [ "string", "null" ] }, "sale_price": { "type": [ "number", "null" ] }, "composition": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "image_links": { "type": "array", "items": { "type": "string" } }, "product_link": { "type": "string" }, "product_name": { "type": [ "string", "null" ] }, "currency_code": { "type": "string" }, "article_number": { "type": "string" }, "care_instructions": { "type": [ "string", "null" ] }, "sustainability_info": { "type": [ "string", "null" ] } } } ``` ## See more - [H&M API: Search products](https://fous.com/methods/hm.com/search-products.md): Searches H&M clothing and home products by keyword, with country-specific prices and an optional sale-only filter. - [Zara API: Get product](https://fous.com/methods/zara.com/get-product.md): Gets a Zara item's price, colours, sizes with availability, materials and images by item name or Zara item link in a chosen country. A name returns the closest match from Zara's search. - [Nike API: Get product](https://fous.com/methods/nike.com/get-product.md): Gets a Nike product's details by name or product link for a chosen country. Returns its colourways, size availability, price and reviews. - [Apple API: Get Apple Store product prices](https://fous.com/methods/apple.com/get-product-prices.md): Gets current Apple Store prices and the configurations on sale for a product in one country. It includes only models sold on that country's public store. - [AliExpress API: Get product](https://fous.com/methods/aliexpress.com/get-product.md): Get one AliExpress product’s prices, variants, reviews, shipping to a chosen country, seller and specifications from its link or the best-selling name match. Sold counts may be rounded, and shipping options are those shown for the displayed variant. - [bhphotovideo.com API: Get B&H Photo product](https://fous.com/methods/bhphotovideo.com/get-product.md): Gets a B&H Photo product's details by name, product link, or B&H number. A name uses the best matching search result; details and prices reflect the public page. - [Amazon API: Get product](https://fous.com/methods/amazon.com/get-product.md): Gets details for an Amazon product, found by name or by link, in a chosen country store. Offer prices, delivery and variants may be missing when Amazon does not show them publicly. - [IKEA API: Check store stock](https://fous.com/methods/ikea.com/check-store-stock.md): Checks a product's price and stock at IKEA stores in a country. Store stock and delivery options appear only where IKEA provides them. - [All H&M methods](https://fous.com/methods/hm.com.md)