PreisradarAnmelden

REST-API

Strukturierte Supermarkt-Angebote aus deutschen Prospekten – maschinenlesbar.

Authentifizierung per Header Authorization: Bearer pr_live_… (Key in den Einstellungen erstellen). Antworten haben die Form { data, meta }, Fehler { error: { code, message } }. Limits: 30 Anfragen/Minute, 5.000/Monat im Free-Plan; Restkontingent im Header X-Quota-Remaining.

Jedes Angebot enthält requires_app und price_without_app (z. B. Lidl Plus), normalisierte Grundpreise (€/kg, €/l) und quality_flags aus der automatischen Plausibilitätsprüfung.

GET /api/v1/offers

Aktuelle Angebote. Parameter: q, retailer (kommagetrennt), category, min_discount, max_price, app=only|exclude, food=true, sort=discount|price|unit_price, limit (≤200), offset.

curl -H "Authorization: Bearer $KEY" \
  "https://DEINE-DOMAIN/api/v1/offers?q=butter&retailer=lidl,aldi-nord&sort=unit_price"

GET /api/v1/products/{id}

Produkt (Marke + Produktart) mit kompletter Preishistorie je Markt und Statistik (min/avg/max).

curl -H "Authorization: Bearer $KEY" https://DEINE-DOMAIN/api/v1/products/2f6c…

GET /api/v1/retailers

Alle unterstützten Märkte.

curl -H "Authorization: Bearer $KEY" https://DEINE-DOMAIN/api/v1/retailers