# Klarna Price Comparison Product Search API

> Klarna price comparison: product search with lowest store prices and top products in 17 countries

- Vendor: `klarnapricecomparisonproductse` · version 1.0 · category Pricing Intelligence · tags klarna api, price comparison api, lowest price api, product search api, shopping prices api, top products api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/klarnapricecomparisonproductse
- This document: https://apiclay.com/docs/klarnapricecomparisonproductse.md
- OpenAPI 3.1: https://apiclay.com/api/klarnapricecomparisonproductse/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `klarnapricecomparisonproductse`
- Updated: 2026-11-18

## About

## Klarna Price Comparison Product Search API

The product search behind Klarna's price comparison in 17 countries (US, UK, Germany, Sweden, Austria, the Netherlands, Denmark, Norway, Finland, France, Spain, Italy, Canada, Poland, Switzerland, Belgium, Ireland): products matching a search with their lowest price across the stores Klarna compares, category, image, stock state and condition, plus suggested categories; and the hot products list with rank, lowest price, price drop, rating, brand, cheapest offer and the number of stores.

Data comes from **klarna.com** (https://www.klarna.com/us/shopping). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/search?market=us&amp;q=airpods`, `/hot-products?market=uk`.

### Routes

#### GET `/search` - Search
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| market | path | string | yes | Country code in lower case: `us`, `uk`, `de`, `se`, `at`, `nl`, `dk`, `no`, `fi`, `fr`, `es`, `it`, `ca`, `pl`, `ch`, `be`, `ie`. |
| q | query | string | yes | Search words, e.g. `airpods`. |

Returns: `products` (up to 9): `id`, `name`, `url`, `categoryName`, `lowestPrice` (`amount`, `currency`), `image.path`, `outOfStock`, `condition`; `suggestions`: category matches with `name`, `url`, `category`, `type`.

#### GET `/hot-products` - Hot products
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| market | path | string | yes | Country code in lower case, as for `/search`. |

Returns: `products` (10): `id`, `name`, `url`, `description`, `lowestPrice`, `category`, `image`, `rank` (`rank`, `trend`), `rating`, `priceDrop`, `brand`, `ribbon`, `previewMerchants` (store count), `cheapestOffer`, `installment`, `outOfStock`, `condition`.

### Caveats

- `url` and `image.path` are paths on klarna.com; product pages are `https://www.klarna.com/` plus the `url`.
- Prices are what Klarna shows at the time of the call, in the market's currency.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by klarna.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /search — Search
- Gateway: `GET https://api.apiclay.com/v1/api/klarnapricecomparisonproductse/search`
- Public query params: `q` (string, required), `market` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /hot-products — Hot products
- Gateway: `GET https://api.apiclay.com/v1/api/klarnapricecomparisonproductse/hot-products`
- Public query params: `market` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/klarnapricecomparisonproductse/search?q=<q>&market=<market>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
