List Klarna search suggestions
List the products, categories, stores and brands Klarna suggests for partly typed text.
Headers
Get your API keyAPI key (`sfk_...`)
What a shopper has typed so far, e.g. `iphone` or `air fryer`.
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.
Endpoint-specific response payload.
Always `found`; a query nothing matches has empty lists.
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 the site suggests (a handful).
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.
Categories, filtered categories, stores and brands.
Suggestion text, e.g. `Apple iPhone 17`.
`CATEGORY`, `FEATURE` (a filtered category), `STORE` or `BRAND`.
Page the suggestion opens.
Category the suggestion is in, when given.
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/suggestions?query=iphone" \
-H "x-api-key: YOUR_API_KEY"Responses
Klarna search suggestions.