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