> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/hm>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/hm.mdx>

---

# H&M API. Products, reviews, stores and suppliers as JSON.

Search H&M's catalogue in any of its online markets, read a product's page and reviews, list its stores and categories, and see the factories behind a product. One consistent shape on every route.

- 8 endpoints
- 48 online markets
- From 1 credit per request

Social Fetch exposes 8 routes under `/v1/hm`. `GET /v1/hm/search` searches the catalogue of one H&M market and returns each product with its price, sale price, colours, sizes and stock indicator, plus the filters and departments with their counts. `GET /v1/hm/products/{id}` returns one product in one colour with every detail its page shows: sizes with online stock, every colour, images, composition, care instructions and rating. `GET /v1/hm/products/{id}/reviews` lists its reviews across every colour and size, with the rating summary on the first page. `GET /v1/hm/search/suggest` completes a partial query. `GET /v1/hm/categories` lists the whole category menu of a market, parents before children. `GET /v1/hm/stores` lists every store in a country with its address, coordinates, opening hours and departments. `GET /v1/hm/countries` lists every country H&M sells in and the languages of each site. `GET /v1/hm/products/{id}/suppliers` lists the suppliers and factories H&M publishes for a product.

A market is a country plus a language: `country=GB`, or `country=CA&language=fr`. Without a language the market's main one is used. Prices are in the market's currency. Product ids are the 10-digit article id from the product page URL, such as `1240531009`; a product page URL is accepted too.

Every response uses the `{ data, meta }` envelope. Lists page with `limit` and `cursor`: pass `page.nextCursor` to get the next page. A search with no match is an empty list, an article missing from the market answers `lookupStatus: not_found`, and so does one H&M lists no suppliers for.

## What you can get

- Product search by keyword in any online H&M market, sorted by relevance, newest or price, up to 72 products a page.
- Each product with `price`, `compareAtPrice` when on sale, colour, every colour swatch, sizes with a stock indicator, images and labels.
- Filters and departments with their counts, spelling suggestions and related searches.
- A product page by article id: sizes with online stock, every colour with its price, images, composition, materials, care instructions, fit details, related articles and rating.
- Product reviews of every colour and size, sorted by date, rating or helpfulness, with fit answers, photos, replies and the star distribution.
- Search suggestions and suggested pages for the start of a query.
- Every store in a country with address, coordinates, phone, weekly hours, special dates, departments and campaigns.
- The full category menu of a market, the country and language list, and the suppliers and factories behind a product.

## H&M endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Search | GET /v1/hm/search | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/hm/search/get) |
| Search suggestions | GET /v1/hm/search/suggest | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/hm/search/suggest/get) |
| Product | GET /v1/hm/products/{id} | 3 credits Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/hm/products/id/get) |
| Product reviews | GET /v1/hm/products/{id}/reviews | 3 credits Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/hm/products/id/reviews/get) |
| Product suppliers | GET /v1/hm/products/{id}/suppliers | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/hm/products/id/suppliers/get) |
| Categories | GET /v1/hm/categories | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/hm/categories/get) |
| Countries | GET /v1/hm/countries | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/hm/countries/get) |
| Stores | GET /v1/hm/stores | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/hm/stores/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_...`). New accounts get 100 free credits, enough to try every H&M route.
2. **Pick the route and the market.** Use `GET /v1/hm/search?query=jeans&country=GB` for a page of products, or `GET /v1/hm/stores?country=DE` for stores. Send `x-api-key` on every request.
3. **Page and bill.** Follow `page.nextCursor` while `page.hasMore` is true, and read `meta.creditsCharged` for the charge.

## Pricing

Most H&M routes charge one credit per completed request; the product and reviews routes charge three. The price is shown on each endpoint page, and each page of a list is its own request. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

H&M has no public API for its catalogue, reviews, stores or suppliers. Social Fetch reads what H&M's own site shows to every visitor and gives it to you as one JSON shape, with markets, currencies and paging handled the same way on every route.

## FAQ

### Is there an H&M API for products and prices?

Yes. GET /v1/hm/search searches the catalogue of one H&M market and returns each product's id, name, URL, price, sale price, colours, sizes, images and labels, with the filters and departments for the search. Authenticate with your Social Fetch API key in x-api-key.

### Which countries can I search?

Any H&M site that sells online, such as US, GB, DE, FR, SE, JP and IN. GET /v1/hm/countries lists every H&M country and its site languages, with onlineStore saying which sell online. A country without an online store answers 400 with a message saying so, and is not charged.

### How do sale prices show?

price is what the product costs now. When it is on sale, compareAtPrice holds the regular price and price the sale price. Amounts are numbers in the market's currency, with the price as H&M shows it in formatted.

### What does the suppliers endpoint return?

The countries of production for an article, each with the suppliers and their factories: name, address and a worker band such as 1501-2000. It is the list H&M shows on the product page. An article H&M lists no suppliers for answers lookupStatus not_found.

### Can I get H&M product reviews?

Yes. GET /v1/hm/products/{id}/reviews lists the reviews of every colour and size of a product with stars, text, fit answers, the colour and size bought, photos and H&M's replies. The first page adds the average rating, the star distribution and the average fit answers.

### How do I page through search results or stores?

Pass page.nextCursor from the previous response as cursor, with the same query and market. The cursor keeps the page size it started with, so pages never overlap. page.hasMore is false on the last page.

### What does the stores endpoint include?

Every H&M store in a country: store code, name, address, coordinates, phone, weekly opening hours, dates with special hours, departments with the collections they carry, and current campaigns. It covers countries without an online store too.

### How much does the H&M API cost?

Most H&M routes charge one credit per completed request; the product and reviews routes charge three. Each page of a list is billed separately. Read meta.creditsCharged on every response. New accounts start with 100 free credits.

### Can I use the H&M routes from agents or MCP?

Yes. Every H&M route is a typed MCP tool and is reachable through Ask (POST /v1/ask) in plain English. Use the typed routes for production jobs.

## Related

- [H&M Product Search API](https://www.socialfetch.dev/platforms/hm/search): Products with prices, colours, sizes and filters (`GET /v1/hm/search`).
- [H&M Product API](https://www.socialfetch.dev/platforms/hm/products-id): One product with sizes, stock, colours and materials (`GET /v1/hm/products/{id}`).
- [H&M Product Reviews API](https://www.socialfetch.dev/platforms/hm/products-id-reviews): Reviews with ratings and fit (`GET /v1/hm/products/{id}/reviews`).
- [H&M Store Locator API](https://www.socialfetch.dev/platforms/hm/stores): Stores in a country with hours and departments (`GET /v1/hm/stores`).
- [H&M Suppliers API](https://www.socialfetch.dev/platforms/hm/products-id-suppliers): Suppliers and factories behind a product (`GET /v1/hm/products/{id}/suppliers`).
- [H&M Categories API](https://www.socialfetch.dev/platforms/hm/categories): The whole category menu of a market (`GET /v1/hm/categories`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language H&M question to the matching operation.
