Skip to main content
GET
Klarna Reviews
Returns a native review page for an independently verified regional product. Supply product_id, a matching regional product URL, or a continuation cursor. URLs are parsed and never followed. Missing products return 404. All 13 catalog regions are supported. Starts with the native USER stream, then continues to the separate CUSTOMER stream when USER ends. A cursor can therefore lead to an empty final CUSTOMER page, which is free. Each items[].review retains date, language, country, publisher, score and native scale, excerpt, author/display name, product label, title, pros/cons and source URL when supplied. A native score/scale of 0/0 denotes an unrated review and is returned as null/null, not zero stars. Reviews can include other countries and variants grouped by the source. Display names do not establish verified-purchase status. source_record_key is an internal content hash, not a platform-issued review ID. Links are metadata only and are never followed. limit is 1–50, default 25. The source can return fewer rows while still offering more. It orders by its own relevance rules, not chronologically, and can switch sections while resetting its batch number. Use next_cursor to retain both section and stream. Direct nextBatchId addresses only the initial priority section and is not a global offset. The response exposes native stream/section/batch metadata separately. total remains null; native overview totals are not a guarantee that this paged source exposes every review. Cursors bind the product, region, limit and filters for one hour. The adapter re-reads the preceding page to check its content and continuation, and rejects adjacent duplicates or changed windows. Restart from the first page if the source changes. After 200 pages, pagination_capped: true explicitly indicates the local ceiling; no cursor is fabricated beyond that ceiling. since and until are inclusive valid YYYY-MM-DD filters because native dates have day precision. They filter each fetched page, excluding undated rows when filtering. source_returned_count and filtered_out retain the candidate counts. An empty filtered page can still have a next cursor. Date ordering is not assumed, so filtering never stops the source traversal early. AI labels, reports, judgments, dry-run analysis and fit enrichment remain unavailable and fail explicitly. label=none and judgments=off are accepted. A fresh nonempty page costs 5 credits. Empty pages, failures, cache hits and successful idempotent replays cost zero. Use X-Max-Credits: 5. Each call performs two anonymous source reads, or three with a cursor anchor. A shared 20-source-request/minute ceiling, 25-second total timeout and 2 MiB limit per response apply. No customer account or personalized review data is accessed.

Authorizations

x-api-key
string
header
required

Headers

Cache-Control
string
Idempotency-Key
string
X-Max-Credits
integer

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.

Required range: x >= 0

Query Parameters

product_id
string

Positive native product ID. Supply this, a matching regional URL, or a cursor retaining the product identity.

Pattern: ^[1-9][0-9]{0,17}$
url
string

Matching HTTPS www.klarna.com regional shopping product URL. Parsed only; never followed.

region
enum<string>
Available options:
usa,
uk,
germany,
sweden,
france,
italy,
spain,
netherlands,
austria,
ireland,
norway,
finland,
denmark
limit
integer
default:25

Requested native page size; the source can return fewer records while still offering continuation.

Required range: 1 <= x <= 50
nextBatchId
integer

Legacy direct batch number in the initial priority section only. Prefer cursor: native section transitions can reset this number.

Required range: 0 <= x <= 100000
label
string

Enrichment is unavailable. Only label=none is accepted.

reports
string

Not implemented by this review adapter; requests specifying this option fail explicitly.

judgments
enum<string>

Enrichment is unavailable. Only judgments=off is accepted.

Available options:
on,
off
dry_run
enum<string>

Not implemented by this review adapter; requests specifying this option fail explicitly.

Available options:
1
label_evidence
enum<string>

Not implemented by this review adapter; requests specifying this option fail explicitly.

Available options:
1
fit
enum<string>

Not implemented by this review adapter; requests specifying this option fail explicitly.

Available options:
goal
goal
string

Not implemented by this review adapter; requests specifying this option fail explicitly.

fit_tokens
integer

Not implemented by this review adapter; requests specifying this option fail explicitly.

since
string

Inclusive YYYY-MM-DD filter applied to each fetched native page. Undated rows are excluded with date filters. Empty filtered pages can still have a cursor and cost zero.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
until
string

Inclusive YYYY-MM-DD filter applied to each fetched native page. Undated rows are excluded with date filters. Empty filtered pages can still have a cursor and cost zero.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
cursor
string

Opaque one-hour cursor binding product, region, page size, date filters, source stream and section. Revalidates the preceding source page. Stops after 200 pages and marks pagination_capped.

Response

Native regional review pages with independently verified product identity, stream/section-aware cursors and day-precision filtering. Preserves source order and metadata; no complete-corpus or AI-enrichment claim.

success
boolean
required
platform
string
required
endpoint
string
required
credits_used
integer
required
Required range: x >= 0
credits_remaining
integer | null
required
request_id
string
required
cached
boolean
required
data
object
required

The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null.