# 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

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