> ## 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.

# Systemstatus prüfen

> Leichte Verfügbarkeitsprüfung. Gibt `{ "ok": true }` zurück, wenn der Dienst verfügbar ist.



## OpenAPI

````yaml /price-data/global.de.yaml get /ping
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:
  /ping:
    get:
      tags:
        - System
      summary: Systemstatus prüfen
      description: >-
        Leichte Verfügbarkeitsprüfung. Gibt `{ "ok": true }` zurück, wenn der
        Dienst verfügbar ist.
      operationId: /ping
      responses:
        '200':
          description: Dienst ist verfügbar
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthResponse'
              example:
                ok: true
      security: []
components:
  schemas:
    HealthResponse:
      type: object
      required:
        - ok
      properties:
        ok:
          type: boolean
          example: true
  securitySchemes:
    rapidApiKey:
      type: apiKey
      in: header
      name: x-rapidapi-key
      description: Ihr RapidAPI-Schlüssel.

````