Klarna

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.

GET/v1/klarna/search
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
querystringrequiredquery

What to search for, e.g. `toaster` or `sony wh-1000xm5`.

min 1 chars · max 100 chars

countrystringoptionalquery

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.

exactstringoptionalquery

`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

limitintegeroptionalquery

Products per page, 1 to 48. Default: 24.

≥ 1 · ≤ 48

cursorstringoptionalquery

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

Response fields
87

Endpoint-specific response payload.

datalookupStatus
string

Always `found`; a search nothing matches has no products.

one of: found, not_found

dataquery
string

The query asked for.

The Klarna shopping site the answer is from.

datamarketcountry
string

Two-letter country code, e.g. `US`.

datamarketsiteUrl
string

The country's Klarna shopping site, e.g. `https://www.klarna.com/us/shopping/`.

datatotalResults
integernullable

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.

datainterpretedAstext
stringnullable

The words still searched as text; null when Klarna read them all as filters.

The product category the search was narrowed to.

datainterpretedAscategoryid
string

Category id, e.g. `cl94`; pass it as `category` to `/v1/klarna/category`.

datainterpretedAscategoryname
stringnullable

Category name.

datainterpretedAscategoryurl
stringnullable

Category page URL.

The sub-category the search was narrowed to, when one.

datainterpretedAssubcategoryid
string

Sub-category id, e.g. `100003567-100014541`; pass it as `subcategory` to `/v1/klarna/category`.

datainterpretedAssubcategoryname
stringnullable

Sub-category name.

The category's place from the top down, itself last.

datainterpretedAspath[]id
string

Category id, e.g. `t1` or `cl94`.

datainterpretedAspath[]name
stringnullable

Category name.

Filters Klarna read in the words, e.g. a brand.

datainterpretedAsfilters[]id
string

Filter id, e.g. `BRAND`; pass it in `filters` of `/v1/klarna/category`.

datainterpretedAsfilters[]name
stringnullable

Filter name, e.g. `Brand`.

The options it read.

datainterpretedAsfilters[]options[]value
string

Option value, e.g. `25`: `filters=BRAND:25` in `/v1/klarna/category`.

datainterpretedAsfilters[]options[]name
stringnullable

Option name, e.g. `Sony`.

dataspellingSuggestion
stringnullable

The spelling Klarna suggests instead, on the first page, when it has one.

Categories the site shows beside the results, on the first page.

datacategories[]id
string

Category id, e.g. `cl69`, or a sub-category id such as `100003567-100014541`.

datacategories[]name
stringnullable

Category name.

datacategories[]url
stringnullable

Category page URL.

datacategories[]imageUrl
stringnullable

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.

dataquickFilters[]id
string

Filter id, e.g. `BRAND`; pass it in `filters` of `/v1/klarna/category`.

dataquickFilters[]name
stringnullable

Filter name, e.g. `Brand`.

dataquickFilters[]unit
stringnullable

Unit of the values, e.g. `gal`.

The options the site offers, in its order.

dataquickFilters[]options[]value
string

Option value, e.g. `25`: `filters=BRAND:25` in `/v1/klarna/category`.

dataquickFilters[]options[]name
stringnullable

Option name, e.g. `Sony`.

dataquickFilters[]options[]imageUrl
stringnullable

Option image, such as a brand logo, when shown.

Products on this page, in the site's order.

dataproducts[]id
string

Product id; pass it as `productId`.

dataproducts[]name
stringnullable

Product name.

dataproducts[]url
stringnullable

Product page URL.

dataproducts[]description
stringnullable

Short description the card shows.

dataproducts[]imageUrl
stringnullable

Product image URL.

Its category.

dataproducts[]categoryid
string

Category id, e.g. `cl52`.

dataproducts[]categoryname
stringnullable

Category name.

dataproducts[]categoryurl
stringnullable

Category page URL.

dataproducts[]brand
stringnullable

Brand name, when shown.

Lowest price across the stores.

dataproducts[]lowestPriceamount
number

Amount, e.g. `775.99`.

dataproducts[]lowestPricecurrency
string

ISO 4217 currency code, e.g. `USD`.

Price before the drop, on a deal.

dataproducts[]oldPriceamount
number

Amount, e.g. `775.99`.

dataproducts[]oldPricecurrency
string

ISO 4217 currency code, e.g. `USD`.

dataproducts[]priceDropPercent
numbernullable

How far the price dropped, in percent, on a deal.

dataproducts[]rating
numbernullable

Average rating out of 5.

dataproducts[]reviewCount
integernullable

Number of ratings.

dataproducts[]popularityRank
integernullable

Rank by popularity in its category.

dataproducts[]storeCount
integernullable

Stores selling it, when shown.

Stores shown on the card (a few).

dataproducts[]stores[]id
string

Store id; pass it as `storeId`.

dataproducts[]stores[]name
stringnullable

Store name.

dataproducts[]stores[]logoUrl
stringnullable

Store logo URL.

dataproducts[]inStock
booleannullable

Whether any store has it.

dataproducts[]condition
stringnullable

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

dataproducts[]installmentpriceamount
number

Amount, e.g. `775.99`.

dataproducts[]installmentpricecurrency
string

ISO 4217 currency code, e.g. `USD`.

dataproducts[]installmenttermLength
integernullable

Number of instalments, e.g. `12`.

dataproducts[]installmentinterval
stringnullable

How often one is paid, e.g. `MONTHLY`.

dataproducts[]installmentinterestRate
numbernullable

Yearly interest rate in percent, e.g. `13.99`.

dataproducts[]installmentpaymentMethod
stringnullable

Klarna payment method, e.g. `FINANCING` or `PAY_IN_4`.

dataproducts[]topRated
booleannullable

Whether the card carries Klarna's "Top rated" ribbon in its category; null when the list shows no ribbons.

dataproducts[]variantCount
integernullable

How many variants (colours, sizes, editions) the card groups; null when it stands for one product.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datapagetruncated
boolean

True when more rows exist than this list can reach: the list stops here before its end.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.