openapi: 3.2.0 info: title: Monocrawl Klarna API version: 0.1.0 description: One key, one envelope, one credit meter across social, search, commerce and web data. contact: name: Monocrawl support url: https://www.monocrawl.com/contact termsOfService: https://www.monocrawl.com/legal/terms-and-conditions servers: - url: https://www.monocrawl.com security: - ApiKeyHeader: [] tags: - name: Klarna paths: /v1/klarna/categories: get: operationId: klarna_categories tags: - Klarna summary: Klarna categories description: The top-level category tree with each department's children. Costs 1 credit per successful live response. parameters: - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/categories.json title: klarna/categories data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: _warnings: description: Optional warnings supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - string - 'null' count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' has_more: description: Source continuation indicator; null means unknown. type: - boolean - 'null' items: description: Returned records. Source coverage and completeness vary. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: object properties: children: description: Optional children supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true icon: description: Optional icon supplied by this operation. Null means unknown. type: - string - 'null' id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' ordinal: description: Optional ordinal supplied by this operation. Null means unknown. type: - number - 'null' short_name: description: Optional short name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true allOf: - anyOf: - required: - children properties: children: description: Optional children supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true - required: - icon properties: icon: description: Optional icon supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - id properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string minLength: 1 - required: - image_url properties: image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - name properties: name: description: Optional name supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - ordinal properties: ordinal: description: Optional ordinal supplied by this operation. Null means unknown. type: - number - required: - short_name properties: short_name: description: Optional short name supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - url properties: url: description: Original source URL when supplied. type: - string minLength: 1 region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true required: - items x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - _warnings: - example count: 0 has_more: false items: - children: - {} icon: example id: example image_url: https://example.com/example name: example ordinal: 0 short_name: example url: https://example.com/example region: example default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 1 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/categories-children: get: operationId: klarna_categories_children tags: - Klarna summary: Klarna sub-categories description: The children of one category, with their images and their own children. Costs 1 credit per successful live response. parameters: - name: id in: query required: true schema: type: string example: t1 description: Category id, e.g. t1 - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/categories-children.json title: klarna/categories-children data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: children: description: Optional children supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: children: description: Optional children supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' short_name: description: Optional short name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true allOf: - anyOf: - required: - children properties: children: description: Optional children supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: children: description: Optional children supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true - required: - id properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string minLength: 1 - required: - image_url properties: image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - name properties: name: description: Optional name supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - region properties: region: description: Optional region supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - short_name properties: short_name: description: Optional short name supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - url properties: url: description: Original source URL when supplied. type: - string minLength: 1 x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - children: - children: - {} id: example image_url: https://example.com/example name: example url: https://example.com/example count: 0 id: example image_url: https://example.com/example name: example region: example short_name: example url: https://example.com/example default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 1 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/category: get: operationId: klarna_category tags: - Klarna summary: Klarna category products description: Products in a category, sorted and filtered, with the sub-categories and brands the page offers. Costs 3 credits per successful live response. parameters: - name: id in: query required: true schema: type: string example: cl94 description: Category id, e.g. cl94 - name: sort in: query required: false schema: type: string enum: - popularity - price_asc - price_desc - trend - name - rating - price_drop example: popularity description: 'popularity, price_asc, price_desc, trend, name, rating or price_drop Accepted values: popularity, price_asc, price_desc, trend, name, rating, price_drop. Case, spaces, hyphens and underscores are interchangeable.' - name: price_range in: query required: false schema: type: string example: '' description: Price band such as 50-500 - name: limit in: query required: false schema: type: string example: '48' description: Products per page, at most 48 - name: cursor in: query required: false schema: type: string example: '' description: Offset from the previous page - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/category.json title: klarna/category data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: brands: description: Source array was empty in the reviewed captures; item fields remain unspecified. type: - array - 'null' items: {} categories: description: Source array was empty in the reviewed captures; item fields remain unspecified. type: - array - 'null' items: {} category_id: description: Optional category id supplied by this operation. Null means unknown. type: - string - 'null' count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' cursor: description: Opaque next-page token; pass it back unchanged. Null does not prove complete history. type: - string - 'null' dropped: description: Optional dropped supplied by this operation. Null means unknown. type: - number - 'null' has_more: description: Source continuation indicator; null means unknown. type: - boolean - 'null' items: description: Returned records. Source coverage and completeness vary. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: object properties: brand: description: Optional brand supplied by this operation. Null means unknown. type: - string - 'null' cheapest_offer: description: Optional cheapest offer supplied by this operation. Null means unknown. type: - object - 'null' properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' merchant_id: description: Optional merchant id supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' additionalProperties: true condition: description: Optional condition supplied by this operation. Null means unknown. type: - string - 'null' currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' description: description: Source description; null or absent means not supplied. type: - string - 'null' id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string - 'null' installment: description: Optional installment supplied by this operation. Null means unknown. type: - object - 'null' properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' interval: description: Optional interval supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' term_length: description: Optional term length supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true out_of_stock: description: Optional out of stock supplied by this operation. Null means unknown. type: - boolean - 'null' platform: description: Optional platform supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' price_drop: description: Optional price drop supplied by this operation. Null means unknown. type: - object - 'null' properties: oldPrice: description: Optional oldPrice supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true percent: description: Optional percent supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true rank: description: Optional rank supplied by this operation. Null means unknown. type: - number - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - object - 'null' properties: max: description: Optional max supplied by this operation. Null means unknown. type: - number - 'null' value: description: Optional value supplied by this operation. Null means unknown. type: - number - 'null' votes: description: Optional votes supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true retailers_count: description: Optional retailers count supplied by this operation. Null means unknown. type: - number - 'null' title: description: Source title when supplied. type: - string - 'null' type: description: Optional type supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true allOf: - anyOf: - required: - brand properties: brand: description: Optional brand supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - cheapest_offer properties: cheapest_offer: description: Optional cheapest offer supplied by this operation. Null means unknown. type: - object properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' merchant_id: description: Optional merchant id supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' additionalProperties: true - required: - condition properties: condition: description: Optional condition supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - currency properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - description properties: description: description: Source description; null or absent means not supplied. type: - string minLength: 1 - required: - id properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string minLength: 1 - required: - image_url properties: image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - installment properties: installment: description: Optional installment supplied by this operation. Null means unknown. type: - object properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' interval: description: Optional interval supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' term_length: description: Optional term length supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - out_of_stock properties: out_of_stock: description: Optional out of stock supplied by this operation. Null means unknown. type: - boolean - required: - price properties: price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - required: - price_drop properties: price_drop: description: Optional price drop supplied by this operation. Null means unknown. type: - object properties: oldPrice: description: Optional oldPrice supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true percent: description: Optional percent supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true - required: - rank properties: rank: description: Optional rank supplied by this operation. Null means unknown. type: - number - required: - rating properties: rating: description: Source rating; read its accompanying scale and vote count. type: - object properties: max: description: Optional max supplied by this operation. Null means unknown. type: - number - 'null' value: description: Optional value supplied by this operation. Null means unknown. type: - number - 'null' votes: description: Optional votes supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - retailers_count properties: retailers_count: description: Optional retailers count supplied by this operation. Null means unknown. type: - number - required: - title properties: title: description: Source title when supplied. type: - string minLength: 1 - required: - url properties: url: description: Original source URL when supplied. type: - string minLength: 1 region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true required: - items x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - brands: [] categories: [] category_id: example count: 0 cursor: null dropped: 0 has_more: false items: - brand: example cheapest_offer: currency: example merchant_id: example price: 0 condition: example currency: example description: example id: example image_url: https://example.com/example installment: currency: example interval: example price: 0 term_length: 0 out_of_stock: false platform: example price: 0 price_drop: oldPrice: {} percent: example rank: 0 rating: max: 0 value: 0 votes: 0 retailers_count: 0 title: example type: example url: https://example.com/example region: example default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 3 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/category-filters: get: operationId: klarna_category_filters tags: - Klarna summary: Klarna category filters description: The filters a category page offers, grouped, with their types and units. Costs 1 credit per successful live response. parameters: - name: id in: query required: true schema: type: string example: cl94 description: Category id - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/category-filters.json title: klarna/category-filters data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: category_id: description: Optional category id supplied by this operation. Null means unknown. type: - string - 'null' count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' groups: description: Optional groups supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: filters: description: Optional filters supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true platform: description: Optional platform supplied by this operation. Null means unknown. type: - string - 'null' region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true allOf: - anyOf: - required: - category_id properties: category_id: description: Optional category id supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - groups properties: groups: description: Optional groups supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: filters: description: Optional filters supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true - required: - region properties: region: description: Optional region supplied by this operation. Null means unknown. type: - string minLength: 1 x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - category_id: example count: 0 groups: - filters: - {} name: example platform: example region: example default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 1 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/category-guide: get: operationId: klarna_category_guide tags: - Klarna summary: Klarna category buying guide description: 'The buying guide of a category: frequently asked questions and shopping tips. Costs 1 credit per successful live response.' parameters: - name: id in: query required: true schema: type: string example: cl94 description: Category id - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/category-guide.json title: klarna/category-guide data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: category_id: description: Optional category id supplied by this operation. Null means unknown. type: - string - 'null' faq: description: Optional faq supplied by this operation. Null means unknown. type: - object - 'null' properties: questions: description: Optional questions supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: answer: description: Optional answer supplied by this operation. Null means unknown. type: - string - 'null' question: description: Optional question supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true title: description: Source title when supplied. type: - string - 'null' additionalProperties: true platform: description: Optional platform supplied by this operation. Null means unknown. type: - string - 'null' region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' shopping_tips: description: Optional shopping tips supplied by this operation. Null means unknown. type: - object - 'null' properties: tips: description: Optional tips supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: answer: description: Optional answer supplied by this operation. Null means unknown. type: - string - 'null' question: description: Optional question supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true title: description: Source title when supplied. type: - string - 'null' additionalProperties: true sponsored_products: description: Source array was empty in the reviewed captures; item fields remain unspecified. type: - array - 'null' items: {} additionalProperties: true allOf: - anyOf: - required: - category_id properties: category_id: description: Optional category id supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - faq properties: faq: description: Optional faq supplied by this operation. Null means unknown. type: - object properties: questions: description: Optional questions supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: answer: description: Optional answer supplied by this operation. Null means unknown. type: - string - 'null' question: description: Optional question supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true title: description: Source title when supplied. type: - string - 'null' additionalProperties: true - required: - region properties: region: description: Optional region supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - shopping_tips properties: shopping_tips: description: Optional shopping tips supplied by this operation. Null means unknown. type: - object properties: tips: description: Optional tips supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: answer: description: Optional answer supplied by this operation. Null means unknown. type: - string - 'null' question: description: Optional question supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true title: description: Source title when supplied. type: - string - 'null' additionalProperties: true - required: - sponsored_products properties: sponsored_products: description: Source array was empty in the reviewed captures; item fields remain unspecified. type: - array items: {} x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - category_id: example faq: questions: - answer: example question: example title: example platform: example region: example shopping_tips: tips: - answer: example question: example title: example sponsored_products: [] default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 1 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/category-keywords: get: operationId: klarna_category_keywords tags: - Klarna summary: Klarna category keywords description: The popular search keywords of a category. Costs 1 credit per successful live response. parameters: - name: id in: query required: true schema: type: string example: t1 description: Category id - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/category-keywords.json title: klarna/category-keywords data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: category_id: description: Optional category id supplied by this operation. Null means unknown. type: - string - 'null' count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' has_more: description: Source continuation indicator; null means unknown. type: - boolean - 'null' items: description: Returned records. Source coverage and completeness vary. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: object properties: name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true allOf: - anyOf: - required: - name properties: name: description: Optional name supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - url properties: url: description: Original source URL when supplied. type: - string minLength: 1 region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true required: - items x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - category_id: example count: 0 has_more: false items: - name: example url: https://example.com/example region: example default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 1 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/compare: get: operationId: klarna_compare tags: - Klarna summary: Klarna product comparison description: 'Two products side by side: prices, ratings and the category''s attribute groups. Costs 3 credits per successful live response.' parameters: - name: id in: query required: true schema: type: string example: '3331931645' description: First product id - name: id2 in: query required: true schema: type: string example: '3216399795' description: Second product id - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/compare.json title: klarna/compare data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: categories: description: Optional categories supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: attribute_groups: description: Optional attribute groups supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true platform: description: Optional platform supplied by this operation. Null means unknown. type: - string - 'null' products: description: Optional products supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: brand: description: Optional brand supplied by this operation. Null means unknown. type: - string - 'null' category: description: Optional category supplied by this operation. Null means unknown. type: - object - 'null' properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true cheapest_offer: description: Optional cheapest offer supplied by this operation. Null means unknown. type: - object - 'null' properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' additionalProperties: true created_at: description: Source creation time, not the API retrieval time. type: - string - 'null' currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string - 'null' platform: description: Optional platform supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - object - 'null' properties: max: description: Optional max supplied by this operation. Null means unknown. type: - number - 'null' value: description: Optional value supplied by this operation. Null means unknown. type: - number - 'null' votes: description: Optional votes supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true title: description: Source title when supplied. type: - string - 'null' type: description: Optional type supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true allOf: - anyOf: - required: - categories properties: categories: description: Optional categories supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: attribute_groups: description: Optional attribute groups supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true - required: - products properties: products: description: Optional products supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: brand: description: Optional brand supplied by this operation. Null means unknown. type: - string - 'null' category: description: Optional category supplied by this operation. Null means unknown. type: - object - 'null' properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true cheapest_offer: description: Optional cheapest offer supplied by this operation. Null means unknown. type: - object - 'null' properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' additionalProperties: true created_at: description: Source creation time, not the API retrieval time. type: - string - 'null' currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string - 'null' platform: description: Optional platform supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - object - 'null' properties: max: description: Optional max supplied by this operation. Null means unknown. type: - number - 'null' value: description: Optional value supplied by this operation. Null means unknown. type: - number - 'null' votes: description: Optional votes supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true title: description: Source title when supplied. type: - string - 'null' type: description: Optional type supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true - required: - region properties: region: description: Optional region supplied by this operation. Null means unknown. type: - string minLength: 1 x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - categories: - attribute_groups: - {} id: example name: example platform: example products: - brand: example category: id: example name: example url: https://example.com/example cheapest_offer: currency: example price: 0 created_at: '2026-09-01T12:00:00Z' currency: example id: example image_url: https://example.com/example platform: example price: 0 rating: max: 0 value: 0 votes: 0 title: example type: example url: https://example.com/example region: example default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 3 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/price-history: get: operationId: klarna_price_history tags: - Klarna summary: Klarna price history description: The price of a product over time, per retailer offer, with the lowest and highest seen. Costs 3 credits per successful live response. parameters: - name: id in: query required: true schema: type: string example: '3216399795' description: Product id - name: interval in: query required: false schema: type: string enum: - one_month - three_months - all example: three_months description: 'one_month, three_months or all Accepted values: one_month, three_months, all. Case, spaces, hyphens and underscores are interchangeable.' - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/price-history.json title: klarna/price-history data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' has_more: description: Source continuation indicator; null means unknown. type: - boolean - 'null' highest: description: Optional highest supplied by this operation. Null means unknown. type: - number - 'null' interval: description: Optional interval supplied by this operation. Null means unknown. type: - string - 'null' items: description: Returned records. Source coverage and completeness vary. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: object properties: at: description: Optional at supplied by this operation. Null means unknown. type: - string - 'null' merchant: description: Optional merchant supplied by this operation. Null means unknown. type: - string - 'null' merchant_id: description: Optional merchant id supplied by this operation. Null means unknown. type: - string - 'null' offer_id: description: Optional offer id supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' additionalProperties: true allOf: - anyOf: - required: - at properties: at: description: Optional at supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - merchant properties: merchant: description: Optional merchant supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - merchant_id properties: merchant_id: description: Optional merchant id supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - offer_id properties: offer_id: description: Optional offer id supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - price properties: price: description: Source price. Currency, taxes and availability depend on the listing. type: - number lowest: description: Optional lowest supplied by this operation. Null means unknown. type: - number - 'null' merchants: description: Optional merchants supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true product_id: description: Optional product id supplied by this operation. Null means unknown. type: - string - 'null' region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true required: - items x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - count: 0 currency: example has_more: false highest: 0 interval: example items: - at: example merchant: example merchant_id: example offer_id: example price: 0 lowest: 0 merchants: - id: example name: example product_id: example region: example default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 3 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/product: get: operationId: klarna_product tags: - Klarna summary: Klarna product description: 'One product page: description and article, brand, category and breadcrumbs, rating, rank in its category, retailer count, cheapest instalment and the full specification table. Costs 3 credits per successful live response.' parameters: - name: id in: query required: true schema: type: string example: '3216399795' description: Product id, as returned by search - name: category in: query required: true schema: type: string example: cl94 description: The product's category id, as returned by search - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/product.json title: klarna/product data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: article: description: Optional article supplied by this operation. Null means unknown. type: - string - 'null' brand: description: Optional brand supplied by this operation. Null means unknown. type: - object - 'null' properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' logo_url: description: Optional logo url supplied by this operation. Null means unknown. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true breadcrumbs: description: Optional breadcrumbs supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true category: description: Optional category supplied by this operation. Null means unknown. type: - object - 'null' properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true description: description: Source description; null or absent means not supplied. type: - string - 'null' id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' images: description: Source array was empty in the reviewed captures; item fields remain unspecified. type: - array - 'null' items: {} installment: description: Optional installment supplied by this operation. Null means unknown. type: - object - 'null' properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' interest_rate: description: Optional interest rate supplied by this operation. Null means unknown. type: - number - 'null' interval: description: Optional interval supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' term_length: description: Optional term length supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true platform: description: Optional platform supplied by this operation. Null means unknown. type: - string - 'null' rank: description: Optional rank supplied by this operation. Null means unknown. type: - object - 'null' properties: category: description: Optional category supplied by this operation. Null means unknown. type: - string - 'null' rank: description: Optional rank supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true rating: description: Source rating; read its accompanying scale and vote count. type: - object - 'null' properties: max: description: Optional max supplied by this operation. Null means unknown. type: - number - 'null' value: description: Optional value supplied by this operation. Null means unknown. type: - number - 'null' votes: description: Optional votes supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true retailers_count: description: Optional retailers count supplied by this operation. Null means unknown. type: - number - 'null' specifications: description: Optional specifications supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: description: description: Source description; null or absent means not supplied. type: - string - 'null' group: description: Optional group supplied by this operation. Null means unknown. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' value: description: Optional value supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true title: description: Source title when supplied. type: - string - 'null' type: description: Optional type supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true allOf: - anyOf: - required: - article properties: article: description: Optional article supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - brand properties: brand: description: Optional brand supplied by this operation. Null means unknown. type: - object properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' logo_url: description: Optional logo url supplied by this operation. Null means unknown. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true - required: - breadcrumbs properties: breadcrumbs: description: Optional breadcrumbs supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true - required: - category properties: category: description: Optional category supplied by this operation. Null means unknown. type: - object properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true - required: - description properties: description: description: Source description; null or absent means not supplied. type: - string minLength: 1 - required: - id properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string minLength: 1 - required: - images properties: images: description: Source array was empty in the reviewed captures; item fields remain unspecified. type: - array items: {} - required: - installment properties: installment: description: Optional installment supplied by this operation. Null means unknown. type: - object properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' interest_rate: description: Optional interest rate supplied by this operation. Null means unknown. type: - number - 'null' interval: description: Optional interval supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' term_length: description: Optional term length supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - rank properties: rank: description: Optional rank supplied by this operation. Null means unknown. type: - object properties: category: description: Optional category supplied by this operation. Null means unknown. type: - string - 'null' rank: description: Optional rank supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - rating properties: rating: description: Source rating; read its accompanying scale and vote count. type: - object properties: max: description: Optional max supplied by this operation. Null means unknown. type: - number - 'null' value: description: Optional value supplied by this operation. Null means unknown. type: - number - 'null' votes: description: Optional votes supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - retailers_count properties: retailers_count: description: Optional retailers count supplied by this operation. Null means unknown. type: - number - required: - specifications properties: specifications: description: Optional specifications supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: description: description: Source description; null or absent means not supplied. type: - string - 'null' group: description: Optional group supplied by this operation. Null means unknown. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' value: description: Optional value supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true - required: - title properties: title: description: Source title when supplied. type: - string minLength: 1 - required: - url properties: url: description: Original source URL when supplied. type: - string minLength: 1 x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - article: example brand: id: example logo_url: https://example.com/example name: example breadcrumbs: - id: example name: example url: https://example.com/example category: id: example name: example url: https://example.com/example description: example id: example images: [] installment: currency: example interest_rate: 0 interval: example price: 0 term_length: 0 platform: example rank: category: example rank: 0 rating: max: 0 value: 0 votes: 0 retailers_count: 0 specifications: - description: example group: example name: example value: example title: example type: example url: https://example.com/example default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 3 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/product-offers: get: operationId: klarna_product_offers tags: - Klarna summary: Klarna product offers description: 'Every retailer''s offer for one product: price, stock, shipping, instalment terms and the retailer''s outbound link, plus the product''s images. Costs 3 credits per successful live response.' parameters: - name: id in: query required: true schema: type: string example: '3216399795' description: Product id - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/product-offers.json title: klarna/product-offers data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' has_more: description: Source continuation indicator; null means unknown. type: - boolean - 'null' images: description: Optional images supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - string - 'null' items: description: Returned records. Source coverage and completeness vary. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: object properties: availability: description: Optional availability supplied by this operation. Null means unknown. type: - string - 'null' currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' delivery_time: description: Optional delivery time supplied by this operation. Null means unknown. type: - object - 'null' properties: maxDays: description: Optional maxDays supplied by this operation. Null means unknown. type: - number - 'null' minDays: description: Optional minDays supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' installment: description: Optional installment supplied by this operation. Null means unknown. type: - object - 'null' properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' interval: description: Optional interval supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' term_length: description: Optional term length supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true labels: description: Optional labels supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - string - 'null' merchant: description: Optional merchant supplied by this operation. Null means unknown. type: - string - 'null' merchant_country: description: Optional merchant country supplied by this operation. Null means unknown. type: - string - 'null' merchant_id: description: Optional merchant id supplied by this operation. Null means unknown. type: - string - 'null' merchant_logo_url: description: Optional merchant logo url supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' shipping_cost: description: Optional shipping cost supplied by this operation. Null means unknown. type: - number - 'null' stock_status: description: Optional stock status supplied by this operation. Null means unknown. type: - string - 'null' title: description: Source title when supplied. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true allOf: - anyOf: - required: - availability properties: availability: description: Optional availability supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - currency properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - delivery_time properties: delivery_time: description: Optional delivery time supplied by this operation. Null means unknown. type: - object properties: maxDays: description: Optional maxDays supplied by this operation. Null means unknown. type: - number - 'null' minDays: description: Optional minDays supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - id properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string minLength: 1 - required: - installment properties: installment: description: Optional installment supplied by this operation. Null means unknown. type: - object properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' interval: description: Optional interval supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' term_length: description: Optional term length supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - labels properties: labels: description: Optional labels supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - string - 'null' - required: - merchant properties: merchant: description: Optional merchant supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - merchant_country properties: merchant_country: description: Optional merchant country supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - merchant_id properties: merchant_id: description: Optional merchant id supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - merchant_logo_url properties: merchant_logo_url: description: Optional merchant logo url supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - price properties: price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - required: - shipping_cost properties: shipping_cost: description: Optional shipping cost supplied by this operation. Null means unknown. type: - number - required: - stock_status properties: stock_status: description: Optional stock status supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - title properties: title: description: Source title when supplied. type: - string minLength: 1 - required: - url properties: url: description: Original source URL when supplied. type: - string minLength: 1 product_id: description: Optional product id supplied by this operation. Null means unknown. type: - string - 'null' region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' summary: description: Optional summary supplied by this operation. Null means unknown. type: - object - 'null' properties: internationalOffer: description: Optional internationalOffer supplied by this operation. Null means unknown. type: - object - 'null' properties: condition: description: Optional condition supplied by this operation. Null means unknown. type: - string - 'null' count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' notInStock: description: Optional notInStock supplied by this operation. Null means unknown. type: - boolean - 'null' additionalProperties: true minPriceAcrossAllOffers: description: Optional minPriceAcrossAllOffers supplied by this operation. Null means unknown. type: - object - 'null' properties: amount: type: - number - string - 'null' description: Decimal source amounts are normalized to JSON numbers in the accompanying currency. Non-numeric source labels may remain text; null is unknown. currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true minPriceInStock: description: Optional minPriceInStock supplied by this operation. Null means unknown. type: - object - 'null' properties: amount: type: - number - string - 'null' description: Decimal source amounts are normalized to JSON numbers in the accompanying currency. Non-numeric source labels may remain text; null is unknown. currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true nationalOffer: description: Optional nationalOffer supplied by this operation. Null means unknown. type: - object - 'null' properties: condition: description: Optional condition supplied by this operation. Null means unknown. type: - string - 'null' count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' maxPrice: description: Optional maxPrice supplied by this operation. Null means unknown. type: - object - 'null' properties: amount: type: - number - string - 'null' description: Decimal source amounts are normalized to JSON numbers in the accompanying currency. Non-numeric source labels may remain text; null is unknown. currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true minPrice: description: Optional minPrice supplied by this operation. Null means unknown. type: - object - 'null' properties: amount: type: - number - string - 'null' description: Decimal source amounts are normalized to JSON numbers in the accompanying currency. Non-numeric source labels may remain text; null is unknown. currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true notInStock: description: Optional notInStock supplied by this operation. Null means unknown. type: - boolean - 'null' additionalProperties: true additionalProperties: true additionalProperties: true required: - items x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - count: 0 has_more: false images: - example items: - availability: example currency: example delivery_time: maxDays: 0 minDays: 0 id: example installment: currency: example interval: example price: 0 term_length: 0 labels: - example merchant: example merchant_country: example merchant_id: example merchant_logo_url: https://example.com/example price: 0 shipping_cost: 0 stock_status: example title: example url: https://example.com/example product_id: example region: example summary: internationalOffer: condition: example count: 0 notInStock: false minPriceAcrossAllOffers: amount: example currency: example minPriceInStock: amount: example currency: example nationalOffer: condition: example count: 0 maxPrice: amount: example currency: example minPrice: amount: example currency: example notInStock: false default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 3 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/reviews: get: operationId: klarna_reviews tags: - Klarna summary: Klarna product reviews description: 'Shopper reviews of a product gathered from retailers'' sites: rating, text, source, author, date, pros and cons. Costs 3 credits per successful live response.' parameters: - name: id in: query required: true schema: type: string example: '3207919327' description: Product id - name: limit in: query required: false schema: type: string example: '10' description: Reviews per page, at most 50 - name: cursor in: query required: false schema: type: string example: '' description: Cursor from the previous page - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/reviews.json title: klarna/reviews data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' cursor: description: Opaque next-page token; pass it back unchanged. Null does not prove complete history. type: - string - 'null' dropped: description: Optional dropped supplied by this operation. Null means unknown. type: - number - 'null' has_more: description: Source continuation indicator; null means unknown. type: - boolean - 'null' items: description: Returned records. Source coverage and completeness vary. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: object properties: author: description: Public author information supplied with this record. type: - string - 'null' country: description: Optional country supplied by this operation. Null means unknown. type: - string - 'null' date: description: Optional date supplied by this operation. Null means unknown. type: - string - 'null' kind: description: Optional kind supplied by this operation. Null means unknown. type: - string - 'null' language: description: Optional language supplied by this operation. Null means unknown. type: - string - 'null' product: description: Optional product supplied by this operation. Null means unknown. type: - string - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - number - 'null' rating_max: description: Optional rating max supplied by this operation. Null means unknown. type: - number - 'null' source: description: Optional source supplied by this operation. Null means unknown. type: - string - 'null' source_domain: description: Optional source domain supplied by this operation. Null means unknown. type: - string - 'null' text: description: Source text when supplied. type: - string - 'null' title: description: Source title when supplied. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' votes_down: description: Optional votes down supplied by this operation. Null means unknown. type: - number - 'null' votes_up: description: Optional votes up supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true allOf: - anyOf: - required: - author properties: author: description: Public author information supplied with this record. type: - string minLength: 1 - required: - country properties: country: description: Optional country supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - date properties: date: description: Optional date supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - language properties: language: description: Optional language supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - product properties: product: description: Optional product supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - rating properties: rating: description: Source rating; read its accompanying scale and vote count. type: - number - required: - rating_max properties: rating_max: description: Optional rating max supplied by this operation. Null means unknown. type: - number - required: - source properties: source: description: Optional source supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - source_domain properties: source_domain: description: Optional source domain supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - text properties: text: description: Source text when supplied. type: - string minLength: 1 - required: - title properties: title: description: Source title when supplied. type: - string minLength: 1 - required: - url properties: url: description: Original source URL when supplied. type: - string minLength: 1 - required: - votes_down properties: votes_down: description: Optional votes down supplied by this operation. Null means unknown. type: - number - required: - votes_up properties: votes_up: description: Optional votes up supplied by this operation. Null means unknown. type: - number product_id: description: Optional product id supplied by this operation. Null means unknown. type: - string - 'null' region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' section: description: Optional section supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true required: - items x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - count: 0 cursor: null dropped: 0 has_more: false items: - author: example country: example date: '2026-09-01T12:00:00Z' kind: example language: example product: example rating: 0 rating_max: 0 source: example source_domain: example text: example title: example url: https://example.com/example votes_down: 0 votes_up: 0 product_id: example region: example section: example default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 3 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/reviews-overview: get: operationId: klarna_reviews_overview tags: - Klarna summary: Klarna reviews overview description: 'The rating summary of a product: overall score, counts, score distributions for shoppers and experts, and the first reviews of each kind. Costs 2 credits per successful live response.' parameters: - name: id in: query required: true schema: type: string example: '3207919327' description: Product id - name: limit in: query required: false schema: type: string example: '10' description: Shopper reviews to include, at most 50 - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/reviews-overview.json title: klarna/reviews-overview data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: customer_reviews: description: Optional customer reviews supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: author: description: Public author information supplied with this record. type: - string - 'null' date: description: Optional date supplied by this operation. Null means unknown. type: - string - 'null' kind: description: Optional kind supplied by this operation. Null means unknown. type: - string - 'null' language: description: Optional language supplied by this operation. Null means unknown. type: - string - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - number - 'null' rating_max: description: Optional rating max supplied by this operation. Null means unknown. type: - number - 'null' text: description: Source text when supplied. type: - string - 'null' votes_down: description: Optional votes down supplied by this operation. Null means unknown. type: - number - 'null' votes_up: description: Optional votes up supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true platform: description: Optional platform supplied by this operation. Null means unknown. type: - string - 'null' pro_distribution: description: Optional pro distribution supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - number - 'null' pro_reviews: description: Optional pro reviews supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: author: description: Public author information supplied with this record. type: - string - 'null' cons: description: Optional cons supplied by this operation. Null means unknown. type: - string - 'null' country: description: Optional country supplied by this operation. Null means unknown. type: - string - 'null' date: description: Optional date supplied by this operation. Null means unknown. type: - string - 'null' kind: description: Optional kind supplied by this operation. Null means unknown. type: - string - 'null' language: description: Optional language supplied by this operation. Null means unknown. type: - string - 'null' product: description: Optional product supplied by this operation. Null means unknown. type: - string - 'null' pros: description: Optional pros supplied by this operation. Null means unknown. type: - string - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - number - 'null' rating_max: description: Optional rating max supplied by this operation. Null means unknown. type: - number - 'null' source: description: Optional source supplied by this operation. Null means unknown. type: - string - 'null' source_domain: description: Optional source domain supplied by this operation. Null means unknown. type: - string - 'null' text: description: Source text when supplied. type: - string - 'null' title: description: Source title when supplied. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' votes_down: description: Optional votes down supplied by this operation. Null means unknown. type: - number - 'null' votes_up: description: Optional votes up supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true pro_reviews_count: description: Optional pro reviews count supplied by this operation. Null means unknown. type: - number - 'null' product_id: description: Optional product id supplied by this operation. Null means unknown. type: - string - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - number - 'null' ratings_count: description: Optional ratings count supplied by this operation. Null means unknown. type: - number - 'null' region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' user_distribution: description: Optional user distribution supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - number - 'null' user_reviews: description: Optional user reviews supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: author: description: Public author information supplied with this record. type: - string - 'null' country: description: Optional country supplied by this operation. Null means unknown. type: - string - 'null' date: description: Optional date supplied by this operation. Null means unknown. type: - string - 'null' kind: description: Optional kind supplied by this operation. Null means unknown. type: - string - 'null' language: description: Optional language supplied by this operation. Null means unknown. type: - string - 'null' product: description: Optional product supplied by this operation. Null means unknown. type: - string - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - number - 'null' rating_max: description: Optional rating max supplied by this operation. Null means unknown. type: - number - 'null' source: description: Optional source supplied by this operation. Null means unknown. type: - string - 'null' source_domain: description: Optional source domain supplied by this operation. Null means unknown. type: - string - 'null' text: description: Source text when supplied. type: - string - 'null' title: description: Source title when supplied. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' votes_down: description: Optional votes down supplied by this operation. Null means unknown. type: - number - 'null' votes_up: description: Optional votes up supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true user_reviews_count: description: Optional user reviews count supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true allOf: - anyOf: - required: - customer_reviews properties: customer_reviews: description: Optional customer reviews supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: author: description: Public author information supplied with this record. type: - string - 'null' date: description: Optional date supplied by this operation. Null means unknown. type: - string - 'null' kind: description: Optional kind supplied by this operation. Null means unknown. type: - string - 'null' language: description: Optional language supplied by this operation. Null means unknown. type: - string - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - number - 'null' rating_max: description: Optional rating max supplied by this operation. Null means unknown. type: - number - 'null' text: description: Source text when supplied. type: - string - 'null' votes_down: description: Optional votes down supplied by this operation. Null means unknown. type: - number - 'null' votes_up: description: Optional votes up supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - pro_distribution properties: pro_distribution: description: Optional pro distribution supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - number - 'null' - required: - pro_reviews properties: pro_reviews: description: Optional pro reviews supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: author: description: Public author information supplied with this record. type: - string - 'null' cons: description: Optional cons supplied by this operation. Null means unknown. type: - string - 'null' country: description: Optional country supplied by this operation. Null means unknown. type: - string - 'null' date: description: Optional date supplied by this operation. Null means unknown. type: - string - 'null' kind: description: Optional kind supplied by this operation. Null means unknown. type: - string - 'null' language: description: Optional language supplied by this operation. Null means unknown. type: - string - 'null' product: description: Optional product supplied by this operation. Null means unknown. type: - string - 'null' pros: description: Optional pros supplied by this operation. Null means unknown. type: - string - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - number - 'null' rating_max: description: Optional rating max supplied by this operation. Null means unknown. type: - number - 'null' source: description: Optional source supplied by this operation. Null means unknown. type: - string - 'null' source_domain: description: Optional source domain supplied by this operation. Null means unknown. type: - string - 'null' text: description: Source text when supplied. type: - string - 'null' title: description: Source title when supplied. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' votes_down: description: Optional votes down supplied by this operation. Null means unknown. type: - number - 'null' votes_up: description: Optional votes up supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - pro_reviews_count properties: pro_reviews_count: description: Optional pro reviews count supplied by this operation. Null means unknown. type: - number - required: - product_id properties: product_id: description: Optional product id supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - rating properties: rating: description: Source rating; read its accompanying scale and vote count. type: - number - required: - ratings_count properties: ratings_count: description: Optional ratings count supplied by this operation. Null means unknown. type: - number - required: - region properties: region: description: Optional region supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - user_distribution properties: user_distribution: description: Optional user distribution supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - number - 'null' - required: - user_reviews properties: user_reviews: description: Optional user reviews supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: author: description: Public author information supplied with this record. type: - string - 'null' country: description: Optional country supplied by this operation. Null means unknown. type: - string - 'null' date: description: Optional date supplied by this operation. Null means unknown. type: - string - 'null' kind: description: Optional kind supplied by this operation. Null means unknown. type: - string - 'null' language: description: Optional language supplied by this operation. Null means unknown. type: - string - 'null' product: description: Optional product supplied by this operation. Null means unknown. type: - string - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - number - 'null' rating_max: description: Optional rating max supplied by this operation. Null means unknown. type: - number - 'null' source: description: Optional source supplied by this operation. Null means unknown. type: - string - 'null' source_domain: description: Optional source domain supplied by this operation. Null means unknown. type: - string - 'null' text: description: Source text when supplied. type: - string - 'null' title: description: Source title when supplied. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' votes_down: description: Optional votes down supplied by this operation. Null means unknown. type: - number - 'null' votes_up: description: Optional votes up supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - user_reviews_count properties: user_reviews_count: description: Optional user reviews count supplied by this operation. Null means unknown. type: - number x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - customer_reviews: - author: example date: '2026-09-01T12:00:00Z' kind: example language: example rating: 0 rating_max: 0 text: example votes_down: 0 votes_up: 0 platform: example pro_distribution: - 0 pro_reviews: - author: example cons: example country: example date: '2026-09-01T12:00:00Z' kind: example language: example product: example pros: example rating: 0 rating_max: 0 source: example source_domain: example text: example title: example url: https://example.com/example votes_down: 0 votes_up: 0 pro_reviews_count: 0 product_id: example rating: 0 ratings_count: 0 region: example user_distribution: - 0 user_reviews: - author: example country: example date: '2026-09-01T12:00:00Z' kind: example language: example product: example rating: 0 rating_max: 0 source: example source_domain: example text: example title: example url: https://example.com/example votes_down: 0 votes_up: 0 user_reviews_count: 0 default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 2 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/reviews-pro: get: operationId: klarna_reviews_pro tags: - Klarna summary: Klarna professional reviews description: 'Expert reviews of a product from the press: rating, verdict, source, date, pros and cons. Costs 3 credits per successful live response.' parameters: - name: id in: query required: true schema: type: string example: '3207919327' description: Product id - name: limit in: query required: false schema: type: string example: '10' description: Reviews per page, at most 50 - name: cursor in: query required: false schema: type: string example: '' description: Cursor from the previous page - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/reviews-pro.json title: klarna/reviews-pro data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' cursor: description: Opaque next-page token; pass it back unchanged. Null does not prove complete history. type: - string - 'null' dropped: description: Optional dropped supplied by this operation. Null means unknown. type: - number - 'null' has_more: description: Source continuation indicator; null means unknown. type: - boolean - 'null' items: description: Returned records. Source coverage and completeness vary. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: object properties: author: description: Public author information supplied with this record. type: - string - 'null' cons: description: Optional cons supplied by this operation. Null means unknown. type: - string - 'null' country: description: Optional country supplied by this operation. Null means unknown. type: - string - 'null' date: description: Optional date supplied by this operation. Null means unknown. type: - string - 'null' kind: description: Optional kind supplied by this operation. Null means unknown. type: - string - 'null' language: description: Optional language supplied by this operation. Null means unknown. type: - string - 'null' product: description: Optional product supplied by this operation. Null means unknown. type: - string - 'null' pros: description: Optional pros supplied by this operation. Null means unknown. type: - string - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - number - 'null' rating_max: description: Optional rating max supplied by this operation. Null means unknown. type: - number - 'null' source: description: Optional source supplied by this operation. Null means unknown. type: - string - 'null' source_domain: description: Optional source domain supplied by this operation. Null means unknown. type: - string - 'null' text: description: Source text when supplied. type: - string - 'null' title: description: Source title when supplied. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' votes_down: description: Optional votes down supplied by this operation. Null means unknown. type: - number - 'null' votes_up: description: Optional votes up supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true allOf: - anyOf: - required: - author properties: author: description: Public author information supplied with this record. type: - string minLength: 1 - required: - cons properties: cons: description: Optional cons supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - country properties: country: description: Optional country supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - date properties: date: description: Optional date supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - language properties: language: description: Optional language supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - product properties: product: description: Optional product supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - pros properties: pros: description: Optional pros supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - rating properties: rating: description: Source rating; read its accompanying scale and vote count. type: - number - required: - rating_max properties: rating_max: description: Optional rating max supplied by this operation. Null means unknown. type: - number - required: - source properties: source: description: Optional source supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - source_domain properties: source_domain: description: Optional source domain supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - text properties: text: description: Source text when supplied. type: - string minLength: 1 - required: - title properties: title: description: Source title when supplied. type: - string minLength: 1 - required: - url properties: url: description: Original source URL when supplied. type: - string minLength: 1 - required: - votes_down properties: votes_down: description: Optional votes down supplied by this operation. Null means unknown. type: - number - required: - votes_up properties: votes_up: description: Optional votes up supplied by this operation. Null means unknown. type: - number product_id: description: Optional product id supplied by this operation. Null means unknown. type: - string - 'null' region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' section: description: Optional section supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true required: - items x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - count: 0 cursor: null dropped: 0 has_more: false items: - author: example cons: example country: example date: '2026-09-01T12:00:00Z' kind: example language: example product: example pros: example rating: 0 rating_max: 0 source: example source_domain: example text: example title: example url: https://example.com/example votes_down: 0 votes_up: 0 product_id: example region: example section: example default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 3 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/search: get: operationId: klarna_search tags: - Klarna summary: Klarna product search description: 'Products matching a keyword across every retailer in the catalogue: lowest price, rating, rank, category, cheapest offer and instalment terms. Costs 3 credits per successful live response.' parameters: - name: query in: query required: true schema: type: string example: headphone description: Search keyword - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region: usa, uk, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: limit in: query required: false schema: type: string example: '5' description: Requested rows per response, 1–1000. The source may return fewer. Remaining rows from an already purchased page use a saved cursor and cost zero to retrieve for up to one hour; further native source pages use this endpoint’s normal price. - name: cursor in: query required: false schema: type: string example: '' description: Use the returned cursor unchanged, retaining the original query, filters and limit. Saved mlo1. cursors retrieve already purchased rows at zero credits for up to one hour. A native source cursor, when supplied, starts a normally priced source page. Quote with dry_run before continuing. - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/search.json title: klarna/search data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: brands: description: Source array was empty in the reviewed captures; item fields remain unspecified. type: - array - 'null' items: {} categories: description: Optional categories supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' cursor: description: Opaque next-page token; pass it back unchanged. Null does not prove complete history. type: - string - 'null' dropped: description: Optional dropped supplied by this operation. Null means unknown. type: - number - 'null' has_more: description: Source continuation indicator; null means unknown. type: - boolean - 'null' items: description: Returned records. Source coverage and completeness vary. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: object properties: category: description: Optional category supplied by this operation. Null means unknown. type: - object - 'null' properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true cheapest_offer: description: Optional cheapest offer supplied by this operation. Null means unknown. type: - object - 'null' properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' merchant_id: description: Optional merchant id supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' additionalProperties: true condition: description: Optional condition supplied by this operation. Null means unknown. type: - string - 'null' currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' description: description: Source description; null or absent means not supplied. type: - string - 'null' id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string - 'null' installment: description: Optional installment supplied by this operation. Null means unknown. type: - object - 'null' properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' interval: description: Optional interval supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' term_length: description: Optional term length supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true out_of_stock: description: Optional out of stock supplied by this operation. Null means unknown. type: - boolean - 'null' platform: description: Optional platform supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' price_drop: description: Optional price drop supplied by this operation. Null means unknown. type: - object - 'null' properties: oldPrice: description: Optional oldPrice supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true percent: description: Optional percent supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true rank: description: Optional rank supplied by this operation. Null means unknown. type: - number - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - object - 'null' properties: max: description: Optional max supplied by this operation. Null means unknown. type: - number - 'null' value: description: Optional value supplied by this operation. Null means unknown. type: - number - 'null' votes: description: Optional votes supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true retailers_count: description: Optional retailers count supplied by this operation. Null means unknown. type: - number - 'null' title: description: Source title when supplied. type: - string - 'null' type: description: Optional type supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true allOf: - anyOf: - required: - category properties: category: description: Optional category supplied by this operation. Null means unknown. type: - object properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true - required: - cheapest_offer properties: cheapest_offer: description: Optional cheapest offer supplied by this operation. Null means unknown. type: - object properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' merchant_id: description: Optional merchant id supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' additionalProperties: true - required: - condition properties: condition: description: Optional condition supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - currency properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - description properties: description: description: Source description; null or absent means not supplied. type: - string minLength: 1 - required: - id properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string minLength: 1 - required: - image_url properties: image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - installment properties: installment: description: Optional installment supplied by this operation. Null means unknown. type: - object properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' interval: description: Optional interval supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' term_length: description: Optional term length supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - out_of_stock properties: out_of_stock: description: Optional out of stock supplied by this operation. Null means unknown. type: - boolean - required: - price properties: price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - required: - price_drop properties: price_drop: description: Optional price drop supplied by this operation. Null means unknown. type: - object properties: oldPrice: description: Optional oldPrice supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true percent: description: Optional percent supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true - required: - rank properties: rank: description: Optional rank supplied by this operation. Null means unknown. type: - number - required: - rating properties: rating: description: Source rating; read its accompanying scale and vote count. type: - object properties: max: description: Optional max supplied by this operation. Null means unknown. type: - number - 'null' value: description: Optional value supplied by this operation. Null means unknown. type: - number - 'null' votes: description: Optional votes supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - retailers_count properties: retailers_count: description: Optional retailers count supplied by this operation. Null means unknown. type: - number - required: - title properties: title: description: Source title when supplied. type: - string minLength: 1 - required: - url properties: url: description: Original source URL when supplied. type: - string minLength: 1 query: description: Optional query supplied by this operation. Null means unknown. type: - string - 'null' region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' total: description: Source-reported total; null is unknown. type: - number - 'null' additionalProperties: true required: - items x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - brands: [] categories: - id: example name: example url: https://example.com/example count: 0 cursor: null dropped: 0 has_more: false items: - category: id: example name: example url: https://example.com/example cheapest_offer: currency: example merchant_id: example price: 0 condition: example currency: example description: example id: example image_url: https://example.com/example installment: currency: example interval: example price: 0 term_length: 0 out_of_stock: false platform: example price: 0 price_drop: oldPrice: {} percent: example rank: 0 rating: max: 0 value: 0 votes: 0 retailers_count: 0 title: example type: example url: https://example.com/example query: example region: example total: 0 default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 3 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/search-suggestions: get: operationId: klarna_search_suggestions tags: - Klarna summary: Klarna search suggestions description: Suggested categories and brands for a partial keyword, with the first matching products. Costs 1 credit per successful live response. parameters: - name: query in: query required: true schema: type: string example: headphone description: Partial keyword - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/search-suggestions.json title: klarna/search-suggestions data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' has_more: description: Source continuation indicator; null means unknown. type: - boolean - 'null' items: description: Returned records. Source coverage and completeness vary. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: object properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' kind: description: Optional kind supplied by this operation. Null means unknown. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true allOf: - anyOf: - required: - id properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string minLength: 1 - required: - name properties: name: description: Optional name supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - url properties: url: description: Original source URL when supplied. type: - string minLength: 1 products: description: Optional products supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: condition: description: Optional condition supplied by this operation. Null means unknown. type: - string - 'null' currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string - 'null' out_of_stock: description: Optional out of stock supplied by this operation. Null means unknown. type: - boolean - 'null' platform: description: Optional platform supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' title: description: Source title when supplied. type: - string - 'null' type: description: Optional type supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true query: description: Optional query supplied by this operation. Null means unknown. type: - string - 'null' region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true required: - items x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - count: 0 has_more: false items: - id: example kind: example name: example url: https://example.com/example products: - condition: example currency: example id: example image_url: https://example.com/example out_of_stock: false platform: example price: 0 title: example type: example url: https://example.com/example query: example region: example default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 1 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/store-filters: get: operationId: klarna_store_filters tags: - Klarna summary: Klarna store filters description: 'The filters a store page offers: price range, categories, brands and retailers with counts. Costs 1 credit per successful live response.' parameters: - name: id in: query required: true schema: type: string example: 09f4d635-0452-4f63-9455-c45420d95669 description: Store id, from klarna/stores - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/store-filters.json title: klarna/store-filters data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' has_more: description: Source continuation indicator; null means unknown. type: - boolean - 'null' items: description: Returned records. Source coverage and completeness vary. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: object properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' max: description: Optional max supplied by this operation. Null means unknown. type: - number - 'null' min: description: Optional min supplied by this operation. Null means unknown. type: - number - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' options: description: Optional options supplied by this operation. Null means unknown. type: - array - 'null' items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true type: description: Optional type supplied by this operation. Null means unknown. type: - string - 'null' unit: description: Optional unit supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true allOf: - anyOf: - required: - id properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string minLength: 1 - required: - max properties: max: description: Optional max supplied by this operation. Null means unknown. type: - number - required: - min properties: min: description: Optional min supplied by this operation. Null means unknown. type: - number - required: - name properties: name: description: Optional name supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - options properties: options: description: Optional options supplied by this operation. Null means unknown. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true - required: - unit properties: unit: description: Optional unit supplied by this operation. Null means unknown. type: - string minLength: 1 region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' store_id: description: Optional store id supplied by this operation. Null means unknown. type: - string - 'null' additionalProperties: true required: - items x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - count: 0 has_more: false items: - id: example max: 0 min: 0 name: example options: - {} type: example unit: example region: example store_id: example default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 1 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/store-products: get: operationId: klarna_store_products tags: - Klarna summary: Klarna store products description: Products sold by one partner store, sorted and paged. Costs 3 credits per successful live response. parameters: - name: id in: query required: true schema: type: string example: 09f4d635-0452-4f63-9455-c45420d95669 description: Store id, from klarna/stores - name: sort in: query required: false schema: type: string enum: - popularity - price_asc - price_desc - trend - name - rating - price_drop example: popularity description: 'popularity, price_asc, price_desc, trend, name, rating or price_drop Accepted values: popularity, price_asc, price_desc, trend, name, rating, price_drop. Case, spaces, hyphens and underscores are interchangeable.' - name: limit in: query required: false schema: type: string example: '25' description: Products per page, at most 25 - name: cursor in: query required: false schema: type: string example: '' description: Offset from the previous page - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/store-products.json title: klarna/store-products data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: brands: description: Source array was empty in the reviewed captures; item fields remain unspecified. type: - array - 'null' items: {} categories: description: Source array was empty in the reviewed captures; item fields remain unspecified. type: - array - 'null' items: {} count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' cursor: description: Opaque next-page token; pass it back unchanged. Null does not prove complete history. type: - string - 'null' dropped: description: Optional dropped supplied by this operation. Null means unknown. type: - number - 'null' has_more: description: Source continuation indicator; null means unknown. type: - boolean - 'null' items: description: Returned records. Source coverage and completeness vary. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: object properties: brand: description: Optional brand supplied by this operation. Null means unknown. type: - string - 'null' category: description: Optional category supplied by this operation. Null means unknown. type: - object - 'null' properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' description: description: Source description; null or absent means not supplied. type: - string - 'null' id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string - 'null' installment: description: Optional installment supplied by this operation. Null means unknown. type: - object - 'null' properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' interval: description: Optional interval supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' term_length: description: Optional term length supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true platform: description: Optional platform supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' rank: description: Optional rank supplied by this operation. Null means unknown. type: - number - 'null' rating: description: Source rating; read its accompanying scale and vote count. type: - object - 'null' properties: max: description: Optional max supplied by this operation. Null means unknown. type: - number - 'null' value: description: Optional value supplied by this operation. Null means unknown. type: - number - 'null' votes: description: Optional votes supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true title: description: Source title when supplied. type: - string - 'null' type: description: Optional type supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true allOf: - anyOf: - required: - brand properties: brand: description: Optional brand supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - category properties: category: description: Optional category supplied by this operation. Null means unknown. type: - object properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true - required: - currency properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - description properties: description: description: Source description; null or absent means not supplied. type: - string minLength: 1 - required: - id properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string minLength: 1 - required: - image_url properties: image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - installment properties: installment: description: Optional installment supplied by this operation. Null means unknown. type: - object properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' interval: description: Optional interval supplied by this operation. Null means unknown. type: - string - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' term_length: description: Optional term length supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - price properties: price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - required: - rank properties: rank: description: Optional rank supplied by this operation. Null means unknown. type: - number - required: - rating properties: rating: description: Source rating; read its accompanying scale and vote count. type: - object properties: max: description: Optional max supplied by this operation. Null means unknown. type: - number - 'null' value: description: Optional value supplied by this operation. Null means unknown. type: - number - 'null' votes: description: Optional votes supplied by this operation. Null means unknown. type: - number - 'null' additionalProperties: true - required: - title properties: title: description: Source title when supplied. type: - string minLength: 1 - required: - url properties: url: description: Original source URL when supplied. type: - string minLength: 1 region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' store_id: description: Optional store id supplied by this operation. Null means unknown. type: - string - 'null' total: description: Source-reported total; null is unknown. type: - number - 'null' additionalProperties: true required: - items x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - brands: [] categories: [] count: 0 cursor: null dropped: 0 has_more: false items: - brand: example category: id: example name: example url: https://example.com/example currency: example description: example id: example image_url: https://example.com/example installment: currency: example interval: example price: 0 term_length: 0 platform: example price: 0 rank: 0 rating: max: 0 value: 0 votes: 0 title: example type: example url: https://example.com/example region: example store_id: example total: 0 default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 3 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true /v1/klarna/stores: get: operationId: klarna_stores tags: - Klarna summary: Klarna partner stores description: 'The partner-store directory: name, category, delivery time and cost, payment options and logos. Costs 1 credit per successful live response.' parameters: - name: category in: query required: false schema: type: string example: '' description: Store category filter, e.g. travel - name: cashback in: query required: false schema: type: string example: '' description: true to keep stores with cashback - name: limit in: query required: false schema: type: string example: '24' description: Stores per page, at most 24 - name: cursor in: query required: false schema: type: string example: '' description: Offset from the previous page - name: region in: query required: false schema: type: string enum: - usa - uk - united kingdom - germany - france - italy - spain - netherlands - sweden - norway - denmark - finland - austria - ireland - poland - belgium x-value-aliases: us: usa gb: uk de: germany at: austria dk: denmark fi: finland fr: france ie: ireland it: italy nl: netherlands 'no': norway pl: poland es: spain se: sweden be: belgium example: usa description: 'Catalogue region Accepted values: usa, uk, united kingdom, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, austria, ireland, poland, belgium. Case, spaces, hyphens and underscores are interchangeable.' - name: dry_run in: query required: false schema: type: string enum: - '1' - '0' - 'true' - 'false' example: '1' description: 'Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.' - name: X-Max-Credits in: header required: false schema: type: integer minimum: 0 maximum: 9007199254740991 example: 5 description: Optional credit reservation ceiling for this individual request. Send a non-negative integer in decimal digits. Live execution checks the required reservation after resolving free cache hits or buffered continuation, before charging or calling a supplier. A higher reservation returns HTTP 422 INVALID_PARAMETERS with reason max_credits_exceeded and charges nothing. Invalid header values also return 422. Zero permits only a zero-credit reservation; omitting the header uses normal pricing. dry_run remains a free preview. This does not cap later requests, batches or scheduled runs. security: - ApiKeyHeader: [] - BearerKey: [] responses: '200': description: 'The common success envelope; `data` is endpoint-specific. Many lists use items/count/cursor; bundles use named collections and their documented continuation metadata. HTTP 200 can contain a partial bundle: inspect complete, partial and legs where supplied.' content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: data: $schema: https://json-schema.org/draft/2020-12/schema $id: https://www.monocrawl.com/schemas/klarna/stores.json title: klarna/stores data fields description: Optional data supplied by this operation. Null means unknown. type: object properties: count: description: Number of records in this response, not lifetime or total matches. type: - number - 'null' cursor: description: Opaque next-page token; pass it back unchanged. Null does not prove complete history. type: - string - 'null' dropped: description: Optional dropped supplied by this operation. Null means unknown. type: - number - 'null' has_more: description: Source continuation indicator; null means unknown. type: - boolean - 'null' items: description: Returned records. Source coverage and completeness vary. type: - array items: description: Optional record supplied by this operation. Null means unknown. type: object properties: apple_pay: description: Optional apple pay supplied by this operation. Null means unknown. type: - boolean - 'null' cashback: description: Optional cashback supplied by this operation. Null means unknown. type: - object - 'null' properties: discountLabel: description: Optional discountLabel supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true discountPercentage: description: Optional discountPercentage supplied by this operation. Null means unknown. type: - number - 'null' showUpToPrefix: description: Optional showUpToPrefix supplied by this operation. Null means unknown. type: - boolean - 'null' additionalProperties: true category: description: Optional category supplied by this operation. Null means unknown. type: - string - 'null' delivery: description: Optional delivery supplied by this operation. Null means unknown. type: - object - 'null' properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' max_days: description: Optional max days supplied by this operation. Null means unknown. type: - number - 'null' min_days: description: Optional min days supplied by this operation. Null means unknown. type: - number - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' additionalProperties: true google_pay: description: Optional google pay supplied by this operation. Null means unknown. type: - boolean - 'null' icon_url: description: Optional icon url supplied by this operation. Null means unknown. type: - string - 'null' id: description: Source identifier. Preserve the supplied type and exact value. type: - string - 'null' image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string - 'null' klarna_integrated: description: Optional klarna integrated supplied by this operation. Null means unknown. type: - boolean - 'null' krn: description: Optional krn supplied by this operation. Null means unknown. type: - string - 'null' name: description: Optional name supplied by this operation. Null means unknown. type: - string - 'null' pay_in_store: description: Optional pay in store supplied by this operation. Null means unknown. type: - boolean - 'null' platform: description: Optional platform supplied by this operation. Null means unknown. type: - string - 'null' tier: description: Optional tier supplied by this operation. Null means unknown. type: - string - 'null' type: description: Optional type supplied by this operation. Null means unknown. type: - string - 'null' url: description: Original source URL when supplied. type: - string - 'null' additionalProperties: true allOf: - anyOf: - required: - apple_pay properties: apple_pay: description: Optional apple pay supplied by this operation. Null means unknown. type: - boolean - required: - cashback properties: cashback: description: Optional cashback supplied by this operation. Null means unknown. type: - object properties: discountLabel: description: Optional discountLabel supplied by this operation. Null means unknown. type: - object - 'null' properties: {} additionalProperties: true discountPercentage: description: Optional discountPercentage supplied by this operation. Null means unknown. type: - number - 'null' showUpToPrefix: description: Optional showUpToPrefix supplied by this operation. Null means unknown. type: - boolean - 'null' additionalProperties: true - required: - category properties: category: description: Optional category supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - delivery properties: delivery: description: Optional delivery supplied by this operation. Null means unknown. type: - object properties: currency: description: Optional currency supplied by this operation. Null means unknown. type: - string - 'null' max_days: description: Optional max days supplied by this operation. Null means unknown. type: - number - 'null' min_days: description: Optional min days supplied by this operation. Null means unknown. type: - number - 'null' price: description: Source price. Currency, taxes and availability depend on the listing. type: - number - 'null' additionalProperties: true - required: - google_pay properties: google_pay: description: Optional google pay supplied by this operation. Null means unknown. type: - boolean - required: - icon_url properties: icon_url: description: Optional icon url supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - id properties: id: description: Source identifier. Preserve the supplied type and exact value. type: - string minLength: 1 - required: - image_url properties: image_url: description: Optional image url supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - klarna_integrated properties: klarna_integrated: description: Optional klarna integrated supplied by this operation. Null means unknown. type: - boolean - required: - krn properties: krn: description: Optional krn supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - name properties: name: description: Optional name supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - pay_in_store properties: pay_in_store: description: Optional pay in store supplied by this operation. Null means unknown. type: - boolean - required: - tier properties: tier: description: Optional tier supplied by this operation. Null means unknown. type: - string minLength: 1 - required: - url properties: url: description: Original source URL when supplied. type: - string minLength: 1 region: description: Optional region supplied by this operation. Null means unknown. type: - string - 'null' total: description: Source-reported total; null is unknown. type: - number - 'null' additionalProperties: true required: - items x-contract-version: '2026-09-22' x-validation-scope: Required success payload structure; optional fields and source completeness remain separate. examples: - count: 0 cursor: null dropped: 0 has_more: false items: - apple_pay: false cashback: discountLabel: {} discountPercentage: 0 showUpToPrefix: false category: example delivery: currency: example max_days: 0 min_days: 0 price: 0 google_pay: false icon_url: https://example.com/example id: example image_url: https://example.com/example klarna_integrated: false krn: example name: example pay_in_store: false platform: example tier: example type: example url: https://example.com/example region: example total: 0 default: description: The error envelope — the same shape for every non-2xx status. content: application/json: schema: $ref: '#/components/schemas/Error' x-credits: 1 x-production-available: true x-capacity: status: not_assessed message: Capacity is workload-dependent; configured routes do not establish sustained throughput or an availability guarantee. x-availability-scope: Structural check of the effective registered chain, production permission, adapter, configured cost and quality floor without request parameters. True is not a live-health, credential, quota, subscription-entitlement, complete-data or deployment-exposure guarantee. False means no structurally eligible candidate; null means metadata could not establish availability. Composite child capability still depends on its component routes. x-live-proven: true components: schemas: Error: type: object required: - success - error - credits_used - request_id properties: success: const: false error: type: object required: - type - message - status properties: type: type: string enum: - UNAUTHORIZED - KEY_REVOKED - KEY_LIMIT_EXCEEDED - RATE_LIMITED - INSUFFICIENT_CREDITS - RESOURCE_NOT_FOUND - INVALID_PARAMETERS - TARGET_ACCESS_DENIED - UPSTREAM_ERROR - UPSTREAM_TIMEOUT - FREE_CAPACITY_UNAVAILABLE - CAPACITY_UNAVAILABLE - ENDPOINT_NOT_FOUND - ENDPOINT_NOT_AVAILABLE - FAIR_USE_EXCEEDED - INTERNAL_ERROR message: type: string status: type: integer doc_url: type: string description: Deep link to the exact section of the errors guide for this type. details: type: object credits_used: type: - integer - 'null' description: Confirmed net charge; null when billing is pending reconciliation. Inspect error.details.billing_status and retain request_id. credits_remaining: type: integer request_id: type: string Success: type: object required: - success - platform - endpoint - data - credits_used - credits_remaining - request_id properties: _completeness: type: object description: Reported response completeness, not a guarantee of complete platform history. Missing source assertions remain unknown. properties: state: type: string enum: - complete - partial - unknown scope: type: string inspection_limited: type: boolean success: const: true platform: type: string endpoint: type: string description: The resolved path, e.g. `/v1/github/profile`. data: description: Amazon responses include marketplace.country and marketplace.domain (resolved request marketplace, UK by default). X profiles preserve location, bio_link and cover_url when supplied. TikTok profiles preserve commerce_user, seller, region, location and business_category when supplied; region identifies the account region rather than personal residence. TikTok comments use platform_default selection, which can change between fetches; keep the same video and options when following cursors. Amazon review variant is readable text. Facebook profiles preserve cover_url, following and created_at when supplied; likes_count and followers are distinct and follower totals may be rounded. Endpoint-specific normalized payload, not one universal post/profile schema. Many lists use items/count/cursor; a null cursor means no usable next cursor was supplied, not proof that all history was retrieved. Check has_more and warnings where present. Social full-profile bundles use posts_cursor and posts_pagination.next_params; retain all returned next parameters. YouTube channel bundles instead use recent_videos, cursor and recent_videos_pagination. Inspect complete/partial/legs where supplied for bounded or failed components. Optional model-derived fields are labelled, not source facts. credits_used: type: integer credits_remaining: type: integer request_id: type: string cached: type: boolean stale: type: boolean description: True only for an explicitly labelled, zero-credit reference snapshot served after a temporary upstream failure. age_seconds: type: integer minimum: 0 description: Age of a stale snapshot since its original retrieval; not reset by outage recovery. fetched_at: type: string format: date-time description: Original retrieval time of a stale snapshot, in UTC. synthetic: type: boolean description: Present and true only on the explicitly requested /sandbox surface. Synthetic responses are representative and charged 0 credits; production /v1 never returns them. degraded: type: boolean description: Reserved for sandbox compatibility. Production /v1 reports upstream failure as an error and never serves a representative fallback. securitySchemes: ApiKeyHeader: type: apiKey in: header name: x-api-key description: Your API key (`mn_…`), from the console. The recommended style. BearerKey: type: http scheme: bearer description: The same key as a Bearer token, for clients that only expose an Authorization field. Keys are never accepted in the query string — URLs leak into logs and referrers. x-provenance: method: harvested publisher: Monocrawl source: https://www.monocrawl.com/openapi.json note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json); stamped by stamp-openapi-provenance.py (roadmap#793)