# Klarna (/docs/klarna)

Klarna shopping products, merchant offers, reviews, price history, categories, and stores across 13 regions

Klarna shopping is a 13-region price-comparison catalogue. Search a keyword, open a product, then walk merchant offers, user reviews, and price history. Category and store lists are the other two ways in.

Base URL: `/v1/klarna/...`

## Getting started

Typical path:

1. `GET /v1/klarna/search?query=headphone` for 20 product cards (id, title, lowest price, rating, image).
2. `GET /v1/klarna/product?product_id=3331931731&category_id=cl94` for the description, brand, and specs. Or pass the shopping URL and both ids are extracted.
3. `GET /v1/klarna/product/offers?product_id=3331931731` for the merchant prices. Product detail does not include a list price.
4. `GET /v1/klarna/reviews?product_id=3331931731` for user reviews. Pass `cursor` until `has_more` is false.

`region` defaults to `usa`. Other values: `uk`, `germany`, `sweden`, `france`, `italy`, `spain`, `netherlands`, `austria`, `ireland`, `norway`, `finland`, `denmark`.

A search query that matches nothing comes back as an empty page and is not billed. Unknown product ids return 404 and are not billed.

## Endpoints

## Labels

`/v1/klarna/reviews` and `/v1/klarna/reviews/pro` label each review by default, at no extra credit: `sentiment` (read from the words, never the stars, with `rating_mismatch` when the two clearly disagree) and `issue` (the main problem the review reports) on `computed.labels`. Send `judgments=off` for the page without them. See [Labels](/docs/labels.md) for the field shapes and the labels you can add with `label=`, such as `label=reports&reports=the battery drains quickly`.

## Notes

- All endpoints use `GET` with query parameters
- Authentication via `x-api-key` header
- Responses follow the unified SocialCrawl schema
- Catalogue paths cost 5 credits. Reference lists (categories, suggestions, stores, filters) cost 1 credit.