> ## Documentation Index
> Fetch the complete documentation index at: https://socialquery.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Klarna Review Overview

> Regional source review aggregates and bounded examples, after independent product identity validation. Rating counts and review counts are distinct; empty regional overview results have no net charge.

Returns native regional review aggregates and bounded review examples. `score_count` counts ratings; `user_review_count` and `pro_review_count` count reviews, which can include unrated entries. Those totals must not be treated as interchangeable. Each score-distribution item contains a star level and native count. A source-confirmed unrated region can return empty distribution arrays; no zero-filled distribution is fabricated.

`user_reviews`, `pro_reviews` and `customer_reviews` remain separate. The source is asked for up to three user and three professional examples; its native customer sample is retained when present. Native unrated `0/0` score/scale values are returned as null/null, not zero stars. Each example keeps date, language, country, publisher, native score/scale, excerpt, title, author, product label, pros/cons and source link when provided. Examples can span countries or variants grouped by Klarna; a regional lookup is not a claim that every example was written in that country or for an identical variant. Source links are metadata and are never followed.

`sample_count` counts examples actually returned. Each section retains `has_next`, `next_batch_id` and `source_section` as native metadata. This overview does not retrieve the full review corpus or accept pagination/labeling parameters. `has_ratings_or_reviews: false` indicates an independently verified product with an explicitly empty regional review response; it costs zero credits.

Supply `product_id` or a regional HTTPS `www.klarna.com` shopping product URL. If both are supplied, their IDs must match. The URL region must match `region`; URLs are parsed and never followed. A separate native product lookup confirms identity before fetching insights. A source-confirmed missing product returns 404.

All 13 catalog regions are supported. UK, Swedish and Danish products retain native legacy source paths with null absolute URLs. Source grouping can differ by region. No customer account or personalized data is accessed.

A fresh nonempty result costs **5 credits**. Source-confirmed empty results, failures, cache hits and successful idempotent replays have no net charge. Calls use two anonymous source reads, share Klarna's 20-request/minute ceiling, and have a 25-second total timeout and 2 MiB limit per response.


## OpenAPI

````yaml GET /klarna/reviews/overview
openapi: 3.1.0
info:
  title: SocialQuery API
  version: '2026-10-09'
  description: >-
    Documented requests for public-source records. Inspect accepted inputs and
    credit amounts, then verify the selected operation before integrating
    preview coverage.
servers:
  - url: https://socialquery.dev/v1
security:
  - apiKey: []
paths:
  /klarna/reviews/overview:
    get:
      tags:
        - Klarna
      summary: Klarna Reviews Overview
      description: >-
        Regional source review aggregates and bounded examples, after
        independent product identity validation. Rating counts and review counts
        are distinct; empty regional overview results have no net charge.
      operationId: get_klarna_reviews_overview
      parameters:
        - name: product_id
          in: query
          required: false
          example: '3331931731'
          schema:
            type: string
            pattern: ^[1-9][0-9]{0,17}$
          description: >-
            Native positive product ID. Supply this or a matching regional
            Klarna product URL; conflicting inputs fail.
        - name: url
          in: query
          required: false
          schema:
            type: string
          description: >-
            HTTPS www.klarna.com regional shopping product URL. Region must
            match the request, and any supplied product_id must match its ID.
            URLs are parsed, not followed.
        - name: region
          in: query
          required: false
          schema:
            type: string
            enum:
              - usa
              - uk
              - germany
              - sweden
              - france
              - italy
              - spain
              - netherlands
              - austria
              - ireland
              - norway
              - finland
              - denmark
        - name: Cache-Control
          in: header
          required: false
          example: no-cache
          schema:
            type: string
        - name: Idempotency-Key
          in: header
          required: false
          example: 7a5e1b4c-2d8f-4a3b-9c1e-6e8b4d2a1f3c
          schema:
            type: string
        - name: X-Max-Credits
          in: header
          required: false
          description: >-
            Optional nonnegative integer cap on the maximum request hold. A live
            request whose hold exceeds this cap returns 422
            CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the
            requested limit; cache hits and successful idempotent replays cost
            zero.
          schema:
            type: integer
            minimum: 0
      responses:
        '200':
          description: >-
            Regional source review aggregates and bounded examples, after
            independent product identity validation. Rating counts and review
            counts are distinct; empty regional overview results have no net
            charge.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SocialQueryResponse'
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          product:
                            type: object
                            properties:
                              id:
                                type: string
                              title:
                                type: string
                              source_path:
                                type: string
                              url:
                                type:
                                  - string
                                  - 'null'
                            required:
                              - id
                              - title
                              - source_path
                              - url
                          region:
                            type: string
                          country_code:
                            type: string
                          source:
                            type: string
                          coverage_note:
                            type: string
                          score:
                            type:
                              - number
                              - 'null'
                            minimum: 0
                          score_count:
                            type: integer
                            minimum: 0
                          user_review_count:
                            type: integer
                            minimum: 0
                          pro_review_count:
                            type: integer
                            minimum: 0
                          user_score_distribution:
                            type: array
                            items:
                              type: object
                              properties:
                                stars:
                                  type: integer
                                  minimum: 1
                                  maximum: 5
                                count:
                                  type: integer
                                  minimum: 0
                              required:
                                - stars
                                - count
                          pro_score_distribution:
                            type: array
                            items:
                              type: object
                              properties:
                                stars:
                                  type: integer
                                  minimum: 1
                                  maximum: 5
                                count:
                                  type: integer
                                  minimum: 0
                              required:
                                - stars
                                - count
                          user_reviews:
                            type: object
                            properties:
                              items:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    date:
                                      type:
                                        - string
                                        - 'null'
                                    language:
                                      type:
                                        - string
                                        - 'null'
                                    country_code:
                                      type:
                                        - string
                                        - 'null'
                                    source:
                                      type:
                                        - string
                                        - 'null'
                                    domain:
                                      type:
                                        - string
                                        - 'null'
                                    excerpt:
                                      type:
                                        - string
                                        - 'null'
                                    author:
                                      type:
                                        - string
                                        - 'null'
                                    product_name:
                                      type:
                                        - string
                                        - 'null'
                                    native_type:
                                      type:
                                        - string
                                        - 'null'
                                    title:
                                      type:
                                        - string
                                        - 'null'
                                    pros:
                                      type:
                                        - string
                                        - 'null'
                                    cons:
                                      type:
                                        - string
                                        - 'null'
                                    source_url:
                                      type:
                                        - string
                                        - 'null'
                                    score:
                                      type:
                                        - number
                                        - 'null'
                                      minimum: 0
                                    score_max:
                                      type:
                                        - number
                                        - 'null'
                                      minimum: 0
                                  required:
                                    - date
                                    - language
                                    - country_code
                                    - source
                                    - domain
                                    - excerpt
                                    - author
                                    - product_name
                                    - native_type
                                    - title
                                    - pros
                                    - cons
                                    - source_url
                                    - score
                                    - score_max
                              next_batch_id:
                                type:
                                  - integer
                                  - 'null'
                                minimum: 0
                              has_next:
                                type: boolean
                              source_section:
                                type:
                                  - string
                                  - 'null'
                            required:
                              - items
                              - next_batch_id
                              - has_next
                              - source_section
                          pro_reviews:
                            type: object
                            properties:
                              items:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    date:
                                      type:
                                        - string
                                        - 'null'
                                    language:
                                      type:
                                        - string
                                        - 'null'
                                    country_code:
                                      type:
                                        - string
                                        - 'null'
                                    source:
                                      type:
                                        - string
                                        - 'null'
                                    domain:
                                      type:
                                        - string
                                        - 'null'
                                    excerpt:
                                      type:
                                        - string
                                        - 'null'
                                    author:
                                      type:
                                        - string
                                        - 'null'
                                    product_name:
                                      type:
                                        - string
                                        - 'null'
                                    native_type:
                                      type:
                                        - string
                                        - 'null'
                                    title:
                                      type:
                                        - string
                                        - 'null'
                                    pros:
                                      type:
                                        - string
                                        - 'null'
                                    cons:
                                      type:
                                        - string
                                        - 'null'
                                    source_url:
                                      type:
                                        - string
                                        - 'null'
                                    score:
                                      type:
                                        - number
                                        - 'null'
                                      minimum: 0
                                    score_max:
                                      type:
                                        - number
                                        - 'null'
                                      minimum: 0
                                  required:
                                    - date
                                    - language
                                    - country_code
                                    - source
                                    - domain
                                    - excerpt
                                    - author
                                    - product_name
                                    - native_type
                                    - title
                                    - pros
                                    - cons
                                    - source_url
                                    - score
                                    - score_max
                              next_batch_id:
                                type:
                                  - integer
                                  - 'null'
                                minimum: 0
                              has_next:
                                type: boolean
                              source_section:
                                type:
                                  - string
                                  - 'null'
                            required:
                              - items
                              - next_batch_id
                              - has_next
                              - source_section
                          customer_reviews:
                            type: object
                            properties:
                              items:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    date:
                                      type:
                                        - string
                                        - 'null'
                                    language:
                                      type:
                                        - string
                                        - 'null'
                                    country_code:
                                      type:
                                        - string
                                        - 'null'
                                    source:
                                      type:
                                        - string
                                        - 'null'
                                    domain:
                                      type:
                                        - string
                                        - 'null'
                                    excerpt:
                                      type:
                                        - string
                                        - 'null'
                                    author:
                                      type:
                                        - string
                                        - 'null'
                                    product_name:
                                      type:
                                        - string
                                        - 'null'
                                    native_type:
                                      type:
                                        - string
                                        - 'null'
                                    title:
                                      type:
                                        - string
                                        - 'null'
                                    pros:
                                      type:
                                        - string
                                        - 'null'
                                    cons:
                                      type:
                                        - string
                                        - 'null'
                                    source_url:
                                      type:
                                        - string
                                        - 'null'
                                    score:
                                      type:
                                        - number
                                        - 'null'
                                      minimum: 0
                                    score_max:
                                      type:
                                        - number
                                        - 'null'
                                      minimum: 0
                                  required:
                                    - date
                                    - language
                                    - country_code
                                    - source
                                    - domain
                                    - excerpt
                                    - author
                                    - product_name
                                    - native_type
                                    - title
                                    - pros
                                    - cons
                                    - source_url
                                    - score
                                    - score_max
                              next_batch_id:
                                type:
                                  - integer
                                  - 'null'
                                minimum: 0
                              has_next:
                                type: boolean
                              source_section:
                                type:
                                  - string
                                  - 'null'
                            required:
                              - items
                              - next_batch_id
                              - has_next
                              - source_section
                          sample_count:
                            type: integer
                            minimum: 0
                          has_ratings_or_reviews:
                            type: boolean
                        required:
                          - product
                          - region
                          - country_code
                          - source
                          - coverage_note
                          - score
                          - score_count
                          - user_review_count
                          - pro_review_count
                          - user_score_distribution
                          - pro_score_distribution
                          - user_reviews
                          - pro_reviews
                          - customer_reviews
                          - sample_count
                          - has_ratings_or_reviews
        '400':
          $ref: '#/components/responses/Error400'
        '401':
          $ref: '#/components/responses/Error401'
        '402':
          $ref: '#/components/responses/Error402'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
        '405':
          $ref: '#/components/responses/Error405'
        '409':
          $ref: '#/components/responses/Error409'
        '422':
          $ref: '#/components/responses/Error422'
        '429':
          $ref: '#/components/responses/Error429'
        '500':
          $ref: '#/components/responses/Error500'
        '502':
          $ref: '#/components/responses/Error502'
        '503':
          $ref: '#/components/responses/Error503'
        '504':
          $ref: '#/components/responses/Error504'
components:
  schemas:
    SocialQueryResponse:
      type: object
      required:
        - success
        - platform
        - endpoint
        - credits_used
        - credits_remaining
        - request_id
        - cached
        - data
      properties:
        success:
          type: boolean
          const: true
        platform:
          type: string
        endpoint:
          type: string
        credits_used:
          type: integer
          minimum: 0
        credits_remaining:
          type:
            - integer
            - 'null'
        request_id:
          type: string
        cached:
          type: boolean
        data:
          type: object
          additionalProperties: true
          description: >-
            The selected operation determines the resource fields in this
            object. Source data can omit a metric or report it as null.
    SocialQueryError:
      type: object
      required:
        - success
        - platform
        - endpoint
        - credits_used
        - credits_remaining
        - request_id
        - cached
        - error
      properties:
        success:
          type: boolean
          const: false
        platform:
          type: string
        endpoint:
          type: string
        credits_used:
          type: integer
          minimum: 0
        credits_remaining:
          type:
            - integer
            - 'null'
        request_id:
          type: string
        cached:
          type: boolean
        error:
          type: object
          required:
            - code
            - type
            - message
            - status
            - doc_url
          properties:
            code:
              type: string
            type:
              type: string
            message:
              type: string
            status:
              type: integer
            doc_url:
              type: string
              format: uri
  responses:
    Error400:
      description: Upstream rejected the request.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error401:
      description: Missing, expired, invalid, or revoked API key.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error402:
      description: Insufficient SocialQuery credits.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error403:
      description: Key scope or provider policy denied access.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error404:
      description: Endpoint or upstream resource not found.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error405:
      description: HTTP method is not supported.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error409:
      description: Idempotency conflict or request in progress.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error422:
      description: Invalid parameters.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error429:
      description: Request limit reached.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error500:
      description: Request processing failed.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error502:
      description: Upstream service failed.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error503:
      description: Provider or required service is unavailable.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error504:
      description: Upstream service timed out.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.