Offene Daten: die API der Refil-Prognose

Die Refil-Prognose — ob Sprit gleich teurer oder billiger wird — sind offene Daten: eine öffentliche API ohne Schlüssel und ohne Anmeldung, lizenziert unter CC BY 4.0. Nutze sie in deiner Redaktion, deinem Blog, Forum oder Assistenten und nenne die Quelle.

Was sie liefert

Eine GET-Anfrage liefert für jedes Land oder das gewünschte Land das aktuelle Urteil der Refil-Prognose und die öffentliche Trefferquote:

• verdict: up (steigt), down (fällt) oder none. none heißt nicht „steigt nicht“: Es gibt heute schlicht kein öffentliches Signal.
• signal: die Richtung, der Zieltag (for_date, UTC), das Ablaufdatum (expires_at), die Grundlage (basis.layer: Kalender, Nachrichten, Rohöl oder Detektor) und die Größe (delta) in Skala und Einheit des Landes (ct/L…); ohne Zahl, wenn die Quelle sie nicht kennt.
• confirmation und last_hit: was danach geschah — die zuletzt bestätigte Bewegung und der letzte Treffer.
• accuracy: die öffentliche Trefferquote je Ebene, mit derselben Schwelle wie die Website: Eine Ebene veröffentlicht Zahlen erst ab 30 ausgewerteten Warnungen.
• computed_at und fuel_scope: wann gerechnet wurde, und dass das Signal je Land gilt — für den Korb der Leitkraftstoffe —, nicht je Kraftstoff.

Beispiel

Alle Länder, oder nur eines mit ?country=DE:

curl "https://api.refil.app/api/public/forecast"
curl "https://api.refil.app/api/public/forecast?country=DE"

{
  "license": "CC-BY-4.0",
  "license_url": "https://creativecommons.org/licenses/by/4.0/",
  "attribution": "Refil — refil.app",
  "attribution_url": "https://refil.app/datos-abiertos/",
  "computed_at": "2026-10-09T08:10:00.000Z",
  "fuel_scope": { "basis": "headline_fuels", "fuels": ["gasolina95", "e5", "e10", "dieselA"] },
  "countries": {
    "ES": {
      "country": "ES",
      "verdict": "up",
      "signal": {
        "direction": "up",
        "kind": "upcoming",
        "for_date": "2026-10-10",
        "expires_at": "2026-10-11T00:00:00.000Z",
        "basis": { "layer": "calendar", "source": "BOE", "confidence": "high" },
        "delta": { "value": 4.5, "unit": "cts/L" }
      },
      "confirmation": null,
      "last_hit": {
        "direction": "up", "for_date": "2026-10-02", "layer": "calendar",
        "actual_delta": { "value": 2.4, "unit": "cts/L" }
      }
    }
  },
  "accuracy": { "minSample": 30, "layers": { "calendar": { "sample": "insufficient" } } }
}

Gekürzte Antwort mit Beispielwerten.

Lizenz

Creative Commons Namensnennung 4.0 (CC BY 4.0): Du darfst die Daten kopieren, weitergeben und nutzen, auch kommerziell, solange du die Quelle nennst. CC BY 4.0

So nennst du die Quelle

Die Namensnennung ist Pflicht und enthält einen sichtbaren Link zu Refil, ohne nofollow. Eine Zeile neben den Daten genügt:

Quelle: <a href="https://refil.app/de/offene-daten/">Refil-Prognose</a> (CC BY 4.0)

Quelle: Refil-Prognose (CC BY 4.0)

Zitiert ein Assistent oder Agent die Daten: Er soll „Refil — refil.app“ nennen und die Seite „Steigen die Spritpreise morgen?“ des Marktes verlinken.

Grenzen und gute Praxis

• Die Antwort wird einige Minuten zwischengespeichert: Öfter als alle zehn Minuten musst du nicht abfragen.
• Es ist eine Prognose, keine Garantie: accuracy sagt, wie oft sie stimmt.
• Länder ohne mögliche Prognose (die Schweiz hat keine amtlichen Preise) liefern 404.
• Kostenlos und ohne Verfügbarkeitsgarantie. Antwortet api.refil.app nicht, liefert gasolina-smart-api.marcosnovo.workers.dev denselben Pfad.
• Intensive Nutzung oder eine maßgeschneiderte Integration? Schreib uns.

Lieber nichts programmieren?

Binde das Widget „Steigen die Spritpreise morgen?“ per <iframe> in deine Website, deinen Blog oder dein Forum ein. Ohne Cookies und ohne Analyse, mit Link zur Prognose.

Widget-Code kopieren

KI-Assistenten lesen sie auch über den MCP-Server von Refil (Tool fuel_price_forecast).

Kontakt: marcosnovodev@gmail.com