Search Klarna products
Search Klarna products by text in any Klarna country, with prices, ratings and stores, and the category and filters Klarna read in the words.
Headers
Get your API keyAPI key (`sfk_...`)
What to search for, e.g. `toaster` or `sony wh-1000xm5`.
min 1 chars · max 100 chars
Two-letter country code of the Klarna shopping site, e.g. `US`, `GB`, `DE` or `SE`. Default: `US`. Prices are in that country's currency.
`true` searches the words as typed. Default `false`, as on the site: Klarna may read a category, brand or feature in the words as a filter (`toaster` lists the Toasters category); `interpretedAs` says what it read.
one of: true, false
Products per page, 1 to 48. Default: 24.
≥ 1 · ≤ 48
Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters.
min 1 chars · max 1024 chars
Endpoint-specific response payload.
Always `found`; a search nothing matches has no products.
one of: found, not_found
The query asked for.
The Klarna shopping site the answer is from.
Two-letter country code, e.g. `US`.
The country's Klarna shopping site, e.g. `https://www.klarna.com/us/shopping/`.
Products Klarna counts for the search. Only the first 1,000 can be paged through.
How Klarna read the words, on the first page; null on later pages and when nothing matched.
The words still searched as text; null when Klarna read them all as filters.
The product category the search was narrowed to.
Category id, e.g. `cl94`; pass it as `category` to `/v1/klarna/category`.
Category name.
Category page URL.
The sub-category the search was narrowed to, when one.
Sub-category id, e.g. `100003567-100014541`; pass it as `subcategory` to `/v1/klarna/category`.
Sub-category name.
The category's place from the top down, itself last.
Category id, e.g. `t1` or `cl94`.
Category name.
Filters Klarna read in the words, e.g. a brand.
Filter id, e.g. `BRAND`; pass it in `filters` of `/v1/klarna/category`.
Filter name, e.g. `Brand`.
The options it read.
Option value, e.g. `25`: `filters=BRAND:25` in `/v1/klarna/category`.
Option name, e.g. `Sony`.
The spelling Klarna suggests instead, on the first page, when it has one.
Categories the site shows beside the results, on the first page.
Category id, e.g. `cl69`, or a sub-category id such as `100003567-100014541`.
Category name.
Category page URL.
Category image URL.
Filters the site offers above the results to narrow them, on the first page. Each takes the shape `filters` of `/v1/klarna/category` takes.
Filter id, e.g. `BRAND`; pass it in `filters` of `/v1/klarna/category`.
Filter name, e.g. `Brand`.
Unit of the values, e.g. `gal`.
The options the site offers, in its order.
Option value, e.g. `25`: `filters=BRAND:25` in `/v1/klarna/category`.
Option name, e.g. `Sony`.
Option image, such as a brand logo, when shown.
Products on this page, in the site's order.
Product id; pass it as `productId`.
Product name.
Product page URL.
Short description the card shows.
Product image URL.
Its category.
Category id, e.g. `cl52`.
Category name.
Category page URL.
Brand name, when shown.
Lowest price across the stores.
Amount, e.g. `775.99`.
ISO 4217 currency code, e.g. `USD`.
Price before the drop, on a deal.
Amount, e.g. `775.99`.
ISO 4217 currency code, e.g. `USD`.
How far the price dropped, in percent, on a deal.
Average rating out of 5.
Number of ratings.
Rank by popularity in its category.
Stores selling it, when shown.
Stores shown on the card (a few).
Store id; pass it as `storeId`.
Store name.
Store logo URL.
Whether any store has it.
`NEW`, `USED` or `REFURBISHED`, when shown.
The pay-in-instalments price the card shows, e.g. 12 monthly payments; null when it shows none.
Amount per instalment.
Amount, e.g. `775.99`.
ISO 4217 currency code, e.g. `USD`.
Number of instalments, e.g. `12`.
How often one is paid, e.g. `MONTHLY`.
Yearly interest rate in percent, e.g. `13.99`.
Klarna payment method, e.g. `FINANCING` or `PAY_IN_4`.
Whether the card carries Klarna's "Top rated" ribbon in its category; null when the list shows no ribbons.
How many variants (colours, sizes, editions) the card groups; null when it stands for one product.
Pagination state for the current page.
Whether another page is available.
Cursor for the next page; null on the last page.
True when more rows exist than this list can reach: the list stops here before its end.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/klarna/search?query=toaster" \
-H "x-api-key: YOUR_API_KEY"Responses
Klarna products for a search.