# H&M Product Listing API

> Fetch paginated product listings for a specific category path. Returns product hits with pricing, images, swatches, sizes, and pagination metadata. Each page returns up to 36 products.

Source: https://www.sandbase.ai/apis/hm/product-listing
API reference: https://www.sandbase.ai/apis/hm/product-listing#api

## Facts

- Provider: H&M
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/hm/product-listing`
- 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/product-listing` 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 |  |

## FAQ

### How do I use the H&M Product Listing API?

Send a POST request to https://api.sandbase.ai/v1/api/hm/product-listing 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 Product Listing 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 Product Listing API accept?

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

### What does the H&M Product Listing 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 Product Listing 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 Product Listing API

Fetch paginated product listings for a specific category path. Returns product hits with pricing, images, swatches, sizes, and pagination metadata. Each page returns up to 36 products.

#### 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/product-listing", "page": 1, "sort": "", "category": "men/products/view-all"}'
```

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

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `category` | string | Yes | Category path (e.g. 'men/products/view-all', 'women/products/view-all', 'kids/girls/products/view-all'). |
| `page` | integer | No | Page number for pagination (1-based). |
| `sort` | string | No | Sort order for results. |

#### Pricing

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