Partner-API › Preisverlauf › Antwort

Antwort: /history

{
  "id": "gcsb1xc",
  "title": "Kinder-Tennisschuhe Head Sprint Velcro 4.0",
  "brand": "Head",
  "measurements": 11,
  "first_seen": "2026-07-08",
  "last_seen": "2026-08-25",
  "price_min": 22.27,
  "price_max": 48.90,
  "history": [
    { "date": "2026-07-08T03:14:52", "price": 46.71, "currency": "EUR" },
    { "date": "2026-07-15T03:11:07", "price": 48.90, "currency": "EUR" },
    { "date": "2026-08-25T03:09:41", "price": 22.61, "currency": "EUR" }
  ]
}
FeldTypBeschreibung
idTextDer Artikelcode des angefragten Artikels.
titleText oder null Artikelbezeichnung. null, wenn der Artikel inzwischen aus dem Bestand ist, der Verlauf aber noch vorliegt.
brandText oder nullMarke.
measurementsganze ZahlZahl der zurückgegebenen Messpunkte.
first_seenDatum oder nullDatum der ältesten Messung.
last_seenDatum oder nullDatum der jüngsten Messung.
price_minDezimalzahl oder nullNiedrigster Preis in der Reihe.
price_maxDezimalzahl oder nullHöchster Preis in der Reihe.
history[].dateZeitpunktZeitpunkt der Messung, ISO 8601.
history[].priceDezimalzahlGemessener Preis.
history[].currencyTextWährung, in aller Regel EUR.

Beispiel: Deal holen und Verlauf nachladen

import requests

KOPF = {"X-API-Key": "gw_DEIN_SCHLUESSEL"}
BASIS = "https://goodsway.de/api/partner/v1"

deals = requests.get(f"{BASIS}/deals", headers=KOPF,
                     params={"limit": 1, "min_points": 20},
                     timeout=30).json()["items"]

for d in deals:
    v = requests.get(f"{BASIS}/history/{d['id']}", headers=KOPF,
                     timeout=30).json()
    print(d["title"])
    print("  jetzt   ", d["price_current"], "EUR")
    print("  ueblich ", d["price_typical"], "EUR")
    print("  Spanne  ", v["price_min"], "bis", v["price_max"], "EUR")
    print("  Messungen", v["measurements"], "seit", v["first_seen"])
# 1. Deal holen, id merken
curl -H "X-API-Key: gw_DEIN_SCHLUESSEL" \
  "https://goodsway.de/api/partner/v1/deals?limit=1&min_points=20"

# 2. Verlauf zu dieser id nachladen
curl -H "X-API-Key: gw_DEIN_SCHLUESSEL" \
  "https://goodsway.de/api/partner/v1/history/gcsb1xc"