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

> SocialCrawl covers H&M with 6 endpoints: keyword product search with price, colour, sizes and availability, search suggestions, a store list for each country, the category tree, and the supplier and factory record H&M publishes for each product.

TL;DR: SocialCrawl's H&M API exposes 6 endpoints, 1 to 5 credits per call, all returning one unified JSON schema with computed fields such as engagement rate, language and content category. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Search | GET | `/v1/hm/search` | 5 | Search H&M products by keyword |
| Search Suggestions | GET | `/v1/hm/search/suggestions` | 5 | Get H&M search suggestions |
| Stores | GET | `/v1/hm/stores` | 5 | List H&M stores in a country |
| Countries | GET | `/v1/hm/countries` | 1 | List H&M countries and languages |
| Categories | GET | `/v1/hm/categories` | 1 | Get the H&M category tree |
| Product Suppliers | GET | `/v1/hm/product/suppliers` | 5 | Get H&M suppliers and factories for a product |

## Code example

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

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## FAQ

### What data can I get from the H&M API?

You get product search results with id, name, brand, price, images, colour, sizes, availability and the product page URL, plus search suggestions, a store list per country, the category tree, the list of H&M markets and the supplier and factory record for a product.

### Is there an H&M product detail endpoint?

No. The data source has no product detail path, so GET /v1/hm/search is the way to read product data and each row already carries the price, images, colour and sizes. Pass a product id from a search row to GET /v1/hm/product/suppliers for the factory data.

### Where do I find an H&M product id?

It is the digits in a product page URL: www2.hm.com/en_us/productpage.0963662139.html is product id 0963662139. Every row returned by the search endpoint also carries its product id.

### Can I get H&M data for markets outside the US?

Yes for catalogue search. Pass language as a locale such as en_gb, de_de or fr_fr to switch catalogue. For stores, pass a two-letter country code from GET /v1/hm/countries as query. The category tree is the US tree only.

### Can I find H&M stores near a location?

Not by location. The stores endpoint returns every H&M store in one country as a single page, with store code, name, address, phone, coordinates and opening hours, so filter by coordinates on your side if you need a near-me view.

### Which H&M endpoints cost the least?

The countries list and the category tree are on the standard tier at 1 credit. Search, suggestions, stores and product suppliers are on the advanced tier at 5 credits.

## 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

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- Is there an API for H&M product data?
- How do I search the H&M catalogue by keyword with SocialCrawl?
- How can I get H&M store locations by country through an API?