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

# Idealo API für Preis- und Angebotsdaten

> Idealo-Preisdaten per API abrufen: Angebote, Preise, Versandkosten und Gesamtpreise per EAN/GTIN, Produkt-ID, Suchbegriff oder URL – ohne eigenen Scraper.

Die Idealo API von PricePirate liefert Ihnen die Angebotsdaten eines Idealo-Listings als strukturiertes JSON: alle Anbieter mit Preis, Versandkosten, Gesamtpreis und Position. Sie rufen die Daten per EAN/GTIN, Idealo-Produkt-ID, Suchbegriff oder Produkt-URL ab – ohne eigenen Scraper, ohne Proxy-Infrastruktur.

<Card title="Idealo API auf RapidAPI" icon="api" href="https://rapidapi.com/organization/pricepirate" cta="Auf RapidAPI öffnen" arrow="true">
  Abonnieren Sie das Global-Produkt auf RapidAPI und starten Sie mit Ihrem RapidAPI-Schlüssel.
</Card>

## Welche Daten liefert die API?

Für jedes abgefragte Produkt erhalten Sie das Listing mit allen sichtbaren Angeboten in einem einheitlichen JSON-Format:

* **Angebote pro Anbieter** – Shopname, Shop-URL und Position im Listing
* **Preise** – Produktpreis, Versandkosten und Gesamtpreis je Angebot
* **Preisspannen** – günstigster, durchschnittlicher und höchster Preis des Listings
* **Zusatzinformationen** – Verfügbarkeit, Artikelzustand, Gutschein-Hinweise und Shop-Bewertungen, soweit Idealo sie ausweist
* **Länder** – Idealo Deutschland (`de`) und Österreich (`at`)

## So nutzen Sie die API

Die API arbeitet mit asynchronen Jobs: Sie erstellen einen Lookup-Job und holen das Ergebnis ab, sobald es fertig ist – typischerweise innerhalb weniger Sekunden.

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

Die Antwort enthält eine `job_id`. Damit fragen Sie das Ergebnis ab:

```bash theme={null}
curl --request GET \
  --url https://<rapidapi-host>.p.rapidapi.com/jobs/<job_id> \
  --header 'x-rapidapi-host: <rapidapi-host>' \
  --header 'x-rapidapi-key: <rapidapi-key>'
```

Sobald der Job `completed` ist, enthält die Antwort das Listing mit allen Angeboten – jedes mit `shop_name`, `position`, `price`, `shipping` und `total`.

Neben der Suche per Barcode bietet die Idealo API drei weitere Lookup-Wege:

| Endpunkt                 | Eingabe            | Typischer Einsatz                       |
| ------------------------ | ------------------ | --------------------------------------- |
| `/idealo/search-by-gtin` | EAN / GTIN / UPC   | Eigene Produkte eindeutig nachschlagen  |
| `/idealo/search-by-id`   | Idealo-Produkt-ID  | Bekannte Listings regelmäßig abfragen   |
| `/idealo/search-by-term` | Suchbegriff        | Listings zu einem Produkt erst finden   |
| `/idealo/search-by-url`  | Idealo-Produkt-URL | Listings aus vorhandenen Links auflösen |

Die Suche per Begriff liefert mehrere passende Listings mit Mindestpreis und Angebotszahl; die vollständigen Angebote holen Sie anschließend per `search-by-id`.

## Idealo-Scraper vs. API

Ein eigener Idealo-Scraper wirkt zunächst günstiger – bis er läuft. In der Praxis bedeutet Scraping: Proxys betreiben, Blockaden umgehen, HTML-Änderungen nachpflegen und die Datenqualität laufend prüfen. Jede Layout-Änderung von Idealo kann die Pipeline brechen.

Die API dreht das Verhältnis um: Sie senden eine EAN und bekommen geprüftes, strukturiertes JSON zurück. Wartung, Infrastruktur und Format-Änderungen sind unser Problem, nicht Ihres. Abgerechnet wird pro Anfrage über RapidAPI – Sie skalieren hoch und runter, ohne Fixkosten für Infrastruktur.

## Abgrenzung zur offiziellen Idealo-Partner-API

Idealo bietet Händlern eigene Schnittstellen (PWS) – etwa für Angebots-Uploads und Bestellabwicklung im Direktkauf. Diese Schnittstellen verwalten **Ihre eigenen Angebote**.

Die PricePirate Idealo API beantwortet eine andere Frage: **Was bieten alle Händler auf einem Listing an?** Sie liefert die Wettbewerbssicht – die Datengrundlage für Preisanalysen, Marktbeobachtung und eigene Repricing-Logik.

## Häufige Fragen

<AccordionGroup>
  <Accordion title="Brauche ich einen Idealo-Account?">
    Nein. Sie benötigen nur ein RapidAPI-Konto und ein Abonnement des PricePirate-API-Produkts.
  </Accordion>

  <Accordion title="Welche Barcodes werden unterstützt?">
    Barcodes folgen dem GTIN-Standard (8–14 Stellen) und sind kompatibel mit EAN, UPC und JAN.
  </Accordion>

  <Accordion title="Wie aktuell sind die Daten?">
    Jeder Lookup-Job fragt das Listing live ab. Die Ergebnisse sind typischerweise innerhalb weniger Sekunden verfügbar.
  </Accordion>

  <Accordion title="Gibt es neben Idealo weitere Quellen?">
    Ja. Das Global-Produkt bündelt Idealo, Klarna, PriceRunner, Google Shopping und Allegro in einem einheitlichen Antwortformat. Eine Übersicht finden Sie unter [Price Data API](/docs/solutions/price-data-api).
  </Accordion>

  <Accordion title="Was kostet die API?">
    Die Abrechnung läuft pro Anfrage über RapidAPI. Die aktuellen Pläne finden Sie im [RapidAPI-Listing](https://rapidapi.com/organization/pricepirate).
  </Accordion>
</AccordionGroup>

<Card title="Idealo API abonnieren" icon="rocket" href="https://rapidapi.com/organization/pricepirate" cta="Auf RapidAPI starten" arrow="true">
  Wählen Sie das Global-Produkt und senden Sie Ihre erste Anfrage in wenigen Minuten.
</Card>

## Weiterführend

* [Price Data API: Übersicht aller Quellen](/docs/solutions/price-data-api)
* [API-Referenz mit allen Endpunkten](/docs/api/price-data/overview)
* Sie möchten Preise nicht nur lesen, sondern automatisch anpassen? Dann zu [Idealo Repricing](/docs/solutions/idealo-repricing).