Goodsway Partner-API

Maschineller Zugang zu unseren Preisaufzeichnungen. Version 1, Stand August 2026.

Wir zeichnen Produktpreise dauerhaft auf. Aus dieser Reihe ergibt sich für jeden Artikel, was sein üblicher Preis ist und wann er wirklich unten liegt. Die API gibt diese Auswertung heraus, zusammen mit der Messreihe, aus der sie hervorgeht. Damit lässt sich ein echter Tiefpunkt von einem hochgesetzten Streichpreis unterscheiden.

Basisadresse
https://goodsway.de/api/partner/v1

Die vier Bereiche

BereichEndpunktWofür
Preis-Tiefpunkte /deals Artikel, die aktuell auf einem belegten Tiefpunkt liegen, mit Rabatt, Zeitraum und Zahl der Messungen.
Preisverlauf /history/{id} Die vollständige Messreihe eines Artikels, um den Verlauf selbst zu zeichnen oder nachzurechnen.
Produktsuche /search Freitextsuche über den Artikelbestand mit Marken- und Preisfilter.
Kategorie-Baum /categories Unsere Einteilung über drei Ebenen. Grundlage für alle Kategoriefilter.

Eigenschaften

  • REST über HTTPS. Nur GET, keine schreibenden Aufrufe.
  • JSON, UTF-8. Antworten immer als application/json.
  • Zustandslos. Keine Sitzung, keine Cookies. Jeder Aufruf trägt seinen Schlüssel selbst.
  • Bereichsweise freigeschaltet. Jeder der vier Bereiche wird einzeln freigegeben.
  • Kostenlos gegen Nennung als Quelle.

Wo anfangen

Wenn du noch keinen Zugang hast, führt der Schnellstart in vier Schritten zum ersten Datensatz. Wenn du schon einen Schlüssel hast, sind Authentifizierung und Fehlerbehandlung die beiden Seiten, die du zuerst lesen solltest.