Klarna Store Products
Native store products after an independent regional store-identity check. Exact decimal price bounds filter coarse native candidate pages; a short or empty page can still have a cursor. Source candidate totals and consumed-row counts remain explicit.
sort_by values map to native sorting: popularity, price_low, price_high, trend, name, rating, price_drop. Ranking-based sorts are not recomputed locally; displayed average ratings need not be monotonic.
price_range accepts exact nonnegative decimal bounds, such as 50-100, 50.25-100.75, 50- or -100, in regional currency. The source only applies whole-unit ranges and can include rounded boundary prices outside those bounds. SocialQuery requests a coarse enclosing range, validates the source filter echo, then excludes prices outside the exact requested bounds.
Consequently, a price-filtered page may be short or empty and still have a next cursor. Follow next_cursor until null. source_returned_count counts consumed native candidates; returned_count counts exact matches on this page. total_scope: source_price_candidates makes clear that total is not an exact-match count. Cursor offsets and continuity anchors include excluded candidates, preventing duplicate or skipped source rows.
A fresh nonempty page costs 5 credits; an empty filtered page costs zero. Each call uses two source requests, or three for size-100 cursors.
size is 1–100; offset is 0–10,000. Pagination uses native source offsets. A total at 10,000 is marked total_is_lower_bound: true, because the source may have more rows. pagination_capped explicitly marks the adapter ceiling, not source exhaustion.
Send next_cursor verbatim for subsequent pages. Request settings are restored when omitted and must match if supplied. Product calls must still include id. Cursors expire after one hour and check the preceding source row, so changed source order can require restarting. Size-100 cursor calls verify that row in a separate one-row request; smaller pages include and remove the anchor. This is not a frozen snapshot or a promise of complete catalog retrieval.
All 13 catalog regions are supported: usa, uk, germany, sweden, france, italy, spain, netherlands, austria, ireland, norway, finland and denmark. Store IDs are regional UUIDs; obtain them from the corresponding store directory. An independent native identity lookup makes unknown store IDs return 404 instead of a misleading empty listing. Store links absent in the source remain null.
Access is anonymous and does not create accounts, cards, financing agreements or purchases. Public one-time-card URLs are returned as metadata only; personal eligibility is not inferred and those links are never opened by the adapter. Cashback values are basis points (350 means 3.5%), with the original source label retained. Offers and prices can change.
Calls share the Klarna 20-source-request/minute ceiling, with a 25-second total timeout and 2 MiB limit per source response. Failures, empty results, cache hits and successful idempotent replays have no net charge.Authorizations
Headers
Optional nonnegative integer cap on the maximum request hold. A live request whose hold exceeds this cap returns 422 CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the requested limit; cache hits and successful idempotent replays cost zero.
x >= 0Query Parameters
Store UUID from the regional store directory. The store must exist in this region.
^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$usa, uk, germany, sweden, france, italy, spain, netherlands, austria, ireland, norway, finland, denmark Native candidate page size. Product price filtering can reduce returned_count; consult source_returned_count and next_cursor.
1 <= x <= 100Native candidate-row offset, bounded at 10,000. Prefer the returned cursor for continuity checking.
0 <= x <= 10000popularity, price_low, price_high, trend, name, rating, price_drop Exact regional price bounds, such as 50-100, 50.25-100.75, 50- or -100. The native service uses coarse whole-unit ranges; SocialQuery validates their application then filters each candidate page to the exact requested bounds. A page may be short/empty while next_cursor remains; total counts candidates.
Return data.next_cursor verbatim. For products, also supply id. Omitted settings are restored; supplied settings must match. Expires after one hour and checks the preceding source row. Offset refers to native candidates, including price-excluded rows.
Response
Native store products after an independent regional store-identity check. Exact decimal price bounds filter coarse native candidate pages; a short or empty page can still have a cursor. Source candidate totals and consumed-row counts remain explicit.
x >= 0The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null.