# H&M Search API (https://www.socialcrawl.dev/platforms/hm/search)

> Returns one page of H&M products for a keyword, 36 per page by default, each with product id, name, brand, current and original price, images, colour, sizes, availability, and the product page URL. Sort by relevance (default), newest, price_low, or price_high. Pass language to switch catalogue (en_us default, en_gb, de_de, fr_fr). filters is an H&M facet string from the live payload (colorWithNames, sizes, fits); a guessed filter that the origin cannot parse fails the call rather than returning an empty page. There is no product-detail endpoint on this surface: feed a returned product id into GET /v1/hm/product/suppliers for factory data.

TL;DR: `GET /v1/hm/search` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search keyword, for example t-shirts, jeans, dress. |
| `page` | no | Page number, starting at 1. Prefer the universal cursor parameter. |
| `limit` | no | Products per page, 1 to 36. Default 36. Values above 36 are clamped; 100 crashes the origin. |
| `sort_by` | no | Result ordering: relevance (default), newest, price_low, or price_high. (relevance \| newest \| price_low \| price_high) |
| `language` | no | Catalogue locale as language_region, for example en_us, en_gb, de_de, fr_fr. Omit for the US catalogue. This is not the two-letter locale from GET /v1/hm/countries. |
| `filters` | no | H&M facet filter string. Example: colorWithNames:black_000000. Combine groups with \|\| and values inside a group with \|. Facet ids are listed on every search payload under searchHits.facets. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/hm/search?query=t-shirts" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full H&M API: https://www.socialcrawl.dev/platforms/hm

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing