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

# Übersicht

> Nutzen Sie die Price Data API über RapidAPI für Marktplatzdaten, EAN-Suchen und asynchrone Jobs.

Die Price Data API liefert Preis- und Angebotsdaten für mehrere Marktplatzquellen. Sie abonnieren die API über RapidAPI und senden Anfragen mit Ihrem RapidAPI-Schlüssel.

## Zugriff über RapidAPI

Abonnieren Sie das gewünschte API-Produkt auf RapidAPI:

<Card title="PricePirate auf RapidAPI" icon="external-link" href="https://rapidapi.com/organization/pricepirate" cta="Auf RapidAPI abonnieren" arrow="true">
  Wählen Sie das Global-Produkt. Es enthält die universelle Suche und die quellenspezifischen Endpunkte.
</Card>

## Authentifizierung

RapidAPI verlangt diese Header für Anfragen:

```text theme={null}
x-rapidapi-key: <rapidapi-key>
x-rapidapi-host: <rapidapi-host>
```

Kopieren Sie die Werte aus Ihrem RapidAPI-Dashboard. Behandeln Sie den Schlüssel wie ein Passwort.

## Suchmuster

Der universelle Endpunkt sucht Produkte über GTIN, EAN oder UPC. Setzen Sie `source` auf die gewünschte Quelle.

```bash theme={null}
curl --request POST \
  --url https://<rapidapi-host>.p.rapidapi.com/universal/search-by-gtin \
  --header 'Content-Type: application/json' \
  --header 'x-rapidapi-host: <rapidapi-host>' \
  --header 'x-rapidapi-key: ...' \
  --data '{"source":"idealo","country":"de","values":["4013474101469"]}'
```

## Synchrone und asynchrone Ergebnisse

Einige Quellen liefern Ergebnisse direkt. Andere Quellen starten einen Job und liefern das Ergebnis später.

Bei asynchronen Endpunkten nutzen Sie typischerweise diese Schritte:

1. Starten Sie einen `jobs`-Request.
2. Speichern Sie die zurückgegebene Job-ID.
3. Fragen Sie den Status oder das Ergebnis ab.
4. Nutzen Sie `ping`, wenn die jeweilige API einen einfachen Verfügbarkeitstest anbietet.

## Quellen

Das Global-Produkt bündelt **Klarna**, **PriceRunner**, **Idealo**, **Google Shopping** und **Allegro**. Die Referenz zeigt nur die Global-API, weil sie alle Endpunkte enthält.

## Referenz

Öffnen Sie **Global** in der Navigation, um alle Price Data API Endpunkte zu sehen.