> **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/search>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/hm/search.mdx>

---

# H&M Product Search API

Search one H&M market's catalogue by keyword and get priced products with colours, sizes and filters.

`GET /v1/hm/search` returns `data.products[]`, `data.totalCount`, `data.filters[]`, `data.departments[]` and `data.page`. A product carries `id` (the 10-digit article id), `productCode`, `title`, `url`, `vendor`, `productType`, `availableForSale`, `price`, `compareAtPrice` when on sale, `memberPrice`, `colorName`, `colorCode`, `swatches[]` for every colour, `sizes[]` with a `stockLevel`, `featuredImage`, `modelImage`, `images[]` and `markers[]`.

`query` is up to 200 characters. `country` and `language` pick the market (default `US`); `sort` takes `relevance`, `newest`, `price_low` or `price_high`; `limit` is 1 to 72 (default 36). Pass `page.nextCursor` as `cursor` for the next page.

## Request

- **Endpoint:** `GET /v1/hm/search`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by keyword
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/hm/search/get)
- **Platform page:** [/platforms/hm](https://www.socialfetch.dev/platforms/hm)

## FAQ

### Which markets can I search?

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

### How do sale prices show?

price is what the product costs now. On sale, compareAtPrice holds the regular price. Both carry amount, currency and formatted.

### What is stockLevel on a size?

H&M's own stock indicator for that size: 0 when it is sold out, higher when it is in stock. It is an indicator, not a unit count.

### Does a search with no match fail?

No. It answers lookupStatus found with an empty products list and totalCount 0.

### Can I change the page size while paging?

The cursor keeps the page size it started with, so pages never overlap. Start again without a cursor to use another limit.

### How much does a search page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.
