# Klarna Data API (https://www.socialcrawl.dev/platforms/klarna)

> The SocialCrawl Klarna API reads Klarna's shopping and price-comparison catalogue across 18 endpoints, and leaves Klarna payments alone. Search returns 20 products per call with lowest price and rating, product/offers lists each merchant's price, stock and shipping cost, product/price-history returns per-merchant time series, and reviews, categories and stores cover the rest of the catalogue.

TL;DR: SocialCrawl's Klarna API exposes 18 endpoints, 1 to 9 credits per call, all returning one unified JSON schema with computed fields such as engagement rate, language and content category. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Product | GET | `/v1/klarna/product` | 5 | Get a Klarna product by id or URL |
| Product Offers | GET | `/v1/klarna/product/offers` | 5 | List merchant offers for a Klarna product |
| Search | GET | `/v1/klarna/search` | 5 | Search Klarna products by keyword |
| Search Suggestions | GET | `/v1/klarna/search/suggestions` | 1 | Get Klarna search suggestions |
| Reviews | GET | `/v1/klarna/reviews` | 5 to 9 | Get Klarna user reviews for a product |
| Reviews Pro | GET | `/v1/klarna/reviews/pro` | 5 to 9 | Get Klarna professional reviews for a product |
| Reviews Overview | GET | `/v1/klarna/reviews/overview` | 5 | Get Klarna review totals and score distributions |
| Product Price History | GET | `/v1/klarna/product/price-history` | 5 | Get Klarna price history for a product |
| Product Compare | GET | `/v1/klarna/product/compare` | 5 | Compare two Klarna products |
| Category | GET | `/v1/klarna/category` | 5 | Browse Klarna products in a category |
| Categories | GET | `/v1/klarna/categories` | 1 | List Klarna root categories |
| Categories Children | GET | `/v1/klarna/categories/children` | 1 | Get Klarna sub-categories |
| Category Filters | GET | `/v1/klarna/category/filters` | 1 | Get Klarna filters for a category |
| Category Keywords | GET | `/v1/klarna/category/keywords` | 1 | Get popular Klarna search keywords for a category |
| Category Guide | GET | `/v1/klarna/category/guide` | 1 | Get Klarna buying-guide content for a category |
| Stores | GET | `/v1/klarna/stores` | 1 | List Klarna shopping stores |
| Store Products | GET | `/v1/klarna/store/products` | 5 | List products from a Klarna store |
| Store Filters | GET | `/v1/klarna/store/filters` | 1 | Get Klarna filters for a store page |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/klarna/product" \
  --data-urlencode "product_id=3331931731" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## FAQ

### Is the SocialCrawl Klarna API for payments or shopping data?

It is for shopping data only. It reads Klarna's price-comparison catalogue: products, merchant offers, price history, user and expert reviews, categories and stores. Checkout and payment integration is a separate Klarna product that this API does not touch.

### Which Klarna regions does the API support?

Pass region as usa (the default), uk, germany, sweden, france, italy, spain, netherlands, austria, ireland, norway, finland or denmark. The region changes the currency, the language and the set of merchants you see.

### How do I compare merchant offers for one product on Klarna?

Call product/offers with the product id. Each offer comes back with the seller name, price, currency, stock status and shipping cost. To put two products side by side instead, product/compare returns title, brand, rating, lowest price and image for both.

### Can I see how a Klarna product's offers changed over time?

Yes, product/price-history returns the lowest and highest figures, the currency and a time series per merchant, which is what you need to chart movement. Current offers stay on product/offers.

### What Klarna review data can I get?

reviews returns user reviews, 10 per page, with text, star rating, title, reviewer name, source and date. reviews/pro returns expert reviews with score and source, and reviews/overview gives the average score, user and professional counts and star distributions.

### How do I find a Klarna product id and category id?

Both are in the shopping URL: klarna.com/us/shopping/pl/cl94/3331931731/... has category id cl94 and product id 3331931731. The product endpoint needs the category id when you pass product_id, or you can pass the full URL instead. Search and category rows return both ids.

### Can I browse a Klarna category or one retailer's products?

Yes, category returns 48 products per page, with facet filters from category/filters and sorting by popularity, price_low, price_high, trend, name, rating or price_drop. stores lists retailers 24 per page, and store/products returns one retailer's products 25 per page.

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- Is there a Klarna API for product prices and merchant offers? Does SocialCrawl have one?
- How do I get Klarna price history data with the SocialCrawl API?
- Can SocialCrawl pull Klarna shopping reviews by region?