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

# PriceRunner-Preisabruf-Job erstellen

> Senden Sie einen Produkt-Barcode (EAN / GTIN / UPC) und einen PriceRunner-Ländercode (`uk`, `se`, `dk`). Die Antwort enthält eine `job_id`, die Sie anschließend über `GET /jobs/{job_id}` abfragen.



## OpenAPI

````yaml /price-data/global.de.yaml post /pricerunner/search-by-gtin
openapi: 3.0.3
info:
  title: Global EAN/GTIN Price Data API
  version: 1.0.0
  description: >-
    Eine Barcode-Anfrage liefert Marktdaten aus mehreren Quellen. Diese API
    bündelt fünf Preisquellen - Klarna, PriceRunner, Idealo, Google Shopping und
    Allegro - hinter einem universellen Endpunkt und einem einheitlichen
    Antwortschema. Senden Sie eine EAN / GTIN / UPC, wählen Sie eine Quelle und
    ein Land, und erhalten Sie Händlerangebote für genau dieses Produkt: Preis,
    Versand, Gesamtpreis, Artikelzustand, Verfügbarkeit,
    Gutschein-/Rückgabehinweise und Shop-Bewertungen in einer gemeinsamen
    JSON-Struktur. Die API deckt 29 Länder und 47 Quelle-Land-Kombinationen ab.


    ## Quellen und Abdeckung

    - **klarna** — `at, dk, fi, fr, de, ie, it, nl, no, es, se, us` -
    **pricerunner** — `uk, se, dk` - **idealo** — `de, at` - **google-shopping**
    — `us, nl, de, fr, uk, es, it, be, at, ch, pl, se, dk,
      no, fi, pt, ie, cz, hu, ro, gr, sk, hr, bg, au, ca, br, in, jp`
    - **allegro** — `pl`


    ## So funktioniert es (asynchrone Jobs)

    1. **Job erstellen** - rufen Sie den universellen Endpunkt
       `POST /universal/search-by-gtin` mit `source`, `country` und einem
       Barcode auf. Alternativ nutzen Sie einen quellenspezifischen Endpunkt.
       Sie erhalten eine `job_id`.
    2. **Ergebnisse abfragen** - rufen Sie `GET /jobs/{job_id}` alle 1-2
       Sekunden auf, bis `status` den Wert `completed` hat. Live-Abfragen sind
       typischerweise nach wenigen Sekunden bereit.

    Barcodes folgen dem GTIN-Standard (8-14 Ziffern) und sind mit EAN, UPC und
    JAN kompatibel. Das `result`-Objekt hat über alle Quellen dieselbe Struktur.
    Felder, die eine Quelle nicht liefert, werden als `null` zurückgegeben. Bei
    Google Shopping basieren `price_min`, `price_avg` und `price_max` auf dem
    Gesamtpreis (Artikel + Versand). Bei anderen Quellen beziehen sie sich auf
    den Artikelpreis. Idealo bietet zusätzlich `search-by-id`, `search-by-term`
    und `search-by-url`. `search-by-term` liefert passende Listings mit
    `price_min` und `offers_count`, aber mit leerem `offers`-Array. Nutzen Sie
    `search-by-id`, um ein Listing mit allen Angeboten abzurufen.
servers:
  - url: https://<rapidapi-host>.p.rapidapi.com
security:
  - rapidApiKey: []
tags:
  - name: Universell
    description: Ein Endpunkt, der eine Abfrage an jede Quelle weiterleitet.
  - name: Klarna
    description: Preisdaten aus dem Klarna-Shopping-Netzwerk.
  - name: PriceRunner
    description: Preisdaten aus dem PriceRunner-Vergleichsnetzwerk.
  - name: Idealo
    description: Idealo-Preisvergleichsdaten (Barcode, ID, Suchbegriff, URL).
  - name: Google Shopping
    description: Preisdaten aus Google Shopping.
  - name: Allegro
    description: Marktplatzdaten aus Allegro (Polen).
  - name: Jobs
    description: Job-Ergebnisse abrufen.
  - name: System
    description: Dienststatus.
paths:
  /pricerunner/search-by-gtin:
    post:
      tags:
        - PriceRunner
      summary: PriceRunner-Preisabruf-Job erstellen
      description: >-
        Senden Sie einen Produkt-Barcode (EAN / GTIN / UPC) und einen
        PriceRunner-Ländercode (`uk`, `se`, `dk`). Die Antwort enthält eine
        `job_id`, die Sie anschließend über `GET /jobs/{job_id}` abfragen.
      operationId: /pricerunner/search-by-gtin
      parameters:
        - $ref: '#/components/parameters/RapidApiHostHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PriceRunnerSearchRequest'
            examples:
              uk:
                summary: Einzelner Barcode im Vereinigten Königreich
                value:
                  country: uk
                  values:
                    - '4013474101469'
      responses:
        '200':
          description: Job erstellt
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobCreatedResponse'
        '400':
          description: Ungültige Anfrage
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  parameters:
    RapidApiHostHeader:
      name: x-rapidapi-host
      in: header
      required: true
      description: Ihr RapidAPI-Host.
      schema:
        type: string
        example: <rapidapi-host>
  schemas:
    PriceRunnerSearchRequest:
      type: object
      additionalProperties: false
      required:
        - country
        - values
      properties:
        country:
          $ref: '#/components/schemas/PriceRunnerCountry'
        values:
          $ref: '#/components/schemas/BarcodeList'
    JobCreatedResponse:
      type: object
      required:
        - error
        - job_id
      properties:
        error:
          type: boolean
          example: false
        job_id:
          type: string
          example: f3a1c2b4-5d6e-7f80-9a1b-2c3d4e5f6071
    ErrorResponse:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: boolean
          example: true
        message:
          type: string
          example: country is required
    PriceRunnerCountry:
      type: string
      description: Zweistelliger PriceRunner-Ländercode.
      enum:
        - uk
        - se
        - dk
      example: uk
    BarcodeList:
      type: array
      description: >-
        Genau ein Produkt-Barcode (GTIN / EAN / UPC / JAN), nur Ziffern, 8-14
        Zeichen.
      minItems: 1
      maxItems: 1
      items:
        type: string
        pattern: ^\d{8,14}$
        example: '4013474101469'
  securitySchemes:
    rapidApiKey:
      type: apiKey
      in: header
      name: x-rapidapi-key
      description: Ihr RapidAPI-Schlüssel.

````