Klarna Search API
Search Klarna's products by text and page through the results with prices, ratings and stores.
GET /v1/klarna/search1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/klarna/search?query=toaster&country=US returns data.products, each with id, name, url, lowestPrice, rating and reviewCount, brand and storeCount, plus totalResults and interpretedAs: how Klarna read the words. toaster is narrowed to the Toasters category (cl69); sony wh-1000xm5 keeps its text and reads Sony as a brand filter.
Pass exact=true to search the words as typed. Follow page.nextCursor while page.hasMore is true; the first 1,000 results can be paged. Product ids pass to /v1/klarna/product, and the category and filters in interpretedAs pass to /v1/klarna/category.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Klarna Search API FAQ
What does interpretedAs mean?
Klarna may read a category, brand or feature in the words and search with it as a filter, as its site does. interpretedAs gives the category, sub-category and filters it read, and the words still searched as text. Pass exact=true to turn this off.
How many results can I page through?
totalResults counts every match, but only the first 1,000 can be paged, up to 48 a page. For more, narrow the search or list the category with /v1/klarna/category.
Which countries can I search?
US, CA, GB, IE, DE, AT, CH, NL, BE, FR, ES, IT, PL, SE, NO, DK and FI. Search in the country's language, such as kettle in GB or hörlurar in SE.
How many credits does a request cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
Other Klarna endpoints
- ProductGET /v1/klarna/product
- Product offersGET /v1/klarna/product/offers
- Price historyGET /v1/klarna/product/price-history
- Similar productsGET /v1/klarna/product/similar
- Product reviewsGET /v1/klarna/product/reviews
- Review summaryGET /v1/klarna/product/reviews/summary
- Search suggestionsGET /v1/klarna/search/suggestions
- DealsGET /v1/klarna/deals