# H&M List Products Kr API

> List Korean H&M products by category path. Returns paginated products with Korean names, KRW prices, member prices, images, and facets. Sort by price is supported. The category path maps to the Korean site's navigation structure. Each page returns up to page_size products (default 36).

Source: https://www.sandbase.ai/apis/hm/products-kr
API reference: https://www.sandbase.ai/apis/hm/products-kr#api

## Facts

- Provider: H&M
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/hm/products-kr`
- Price: $0.03 per call
- Capabilities: api, hm, ecommerce, fashion
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/hm/products-kr` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `category` | string | yes |  |
| `page` | integer | no |  |
| `sort` | string | no |  |
| `page_size` | integer | no |  |

## FAQ

### How do I use the H&M List Products Kr API?

Send a POST request to https://api.sandbase.ai/v1/api/hm/products-kr with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the H&M List Products Kr API cost?

$0.03 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the H&M List Products Kr API accept?

Required: category (string). Optional: page (integer), sort (string) and page_size (integer). The Parameters table and the Playground on this page list every field.

### What does the H&M List Products Kr API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a H&M developer account or API key?

No. H&M List Products Kr runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for H&M API access separately.

## README

### H&M List Products Kr API

List Korean H&M products by category path. Returns paginated products with Korean names, KRW prices, member prices, images, and facets. Sort by price is supported. The category path maps to the Korean site's navigation structure. Each page returns up to page_size products (default 36).

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "hm/products-kr", "page": 1, "sort": "ascPrice", "category": "ladies/products/view-all", "page_size": 5}'
```

The result is returned in `outputs[0].data`.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `category` | string | Yes | Korean site category path (e.g. 'ladies/products/view-all', 'men/new-arrivals/view-all', 'ladies/sale/view-all', 'men/jeans/view-all'). |
| `page` | integer | No | Page number for pagination (1-based). |
| `page_size` | integer | No | Number of products per page. |
| `sort` | string | No | Sort order. Supported values: 'ascPrice' (lowest first), 'descPrice' (highest first). Omit for default. |

#### Pricing

Flat $0.03 per call. Failed calls are not charged.