Refil · Dati aperti

Dati aperti: l'API della previsione Refil

Name: Dati aperti: l'API della previsione Refil
Creator: Refil
License: https://creativecommons.org/licenses/by/4.0/

La previsione Refil — se il carburante sta per salire o scendere — è un dato aperto: un'API pubblica, senza chiave né registrazione, con licenza CC BY 4.0. Usala nella tua testata, nel tuo blog, nel tuo forum o nel tuo assistente, citando la fonte.

Cosa restituisce

Una richiesta GET restituisce, per ogni paese o per quello che chiedi, il verdetto in corso della previsione Refil e il tabellino pubblico:

verdict: up (sale), down (scende) o none. none non significa «non sale»: significa che oggi non c'è alcun segnale pubblico.
signal: la direzione, il giorno obiettivo (for_date, UTC), la scadenza (expires_at), su cosa si basa (basis.layer: calendario, notizie, greggio o rilevatore) e l'entità (delta) nella scala e nell'unità del paese (cent/L…); senza cifra se la fonte non la conosce.
confirmation e last_hit: cosa è successo dopo — l'ultimo movimento confermato e l'ultima previsione azzeccata.
accuracy: il tabellino pubblico per livello, con la stessa soglia del sito: un livello pubblica numeri solo con almeno 30 avvisi valutati.
computed_at e fuel_scope: quando è stato calcolato, e il fatto che il segnale è per paese — il paniere dei carburanti di riferimento — e non per singolo carburante.

Esempio

Tutti i paesi, o uno solo con ?country=IT:

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

{
  "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" } } }
}

Risposta abbreviata, con valori di esempio.

Licenza

Creative Commons Attribuzione 4.0 (CC BY 4.0): puoi copiare, ridistribuire e usare i dati, anche a fini commerciali, purché tu citi la fonte. CC BY 4.0

Come citare la fonte

L'attribuzione è obbligatoria e include un link visibile a Refil, senza nofollow. Basta una riga accanto al dato:

Fonte: <a href="https://refil.app/it/dati-aperti/">Previsione Refil</a> (CC BY 4.0)

Fonte: Previsione Refil (CC BY 4.0)

Se la cita un assistente o un agente: deve nominare «Refil — refil.app» e linkare la pagina «La benzina aumenta domani?» del mercato.

Limiti e buone pratiche

La risposta viene memorizzata per alcuni minuti: non serve interrogarla più di una volta ogni dieci.
È una previsione, non una garanzia: accuracy dice quanto spesso ci azzecca.
I paesi senza previsione possibile (la Svizzera non ha prezzi ufficiali) restituiscono 404.
Gratuita e senza garanzia di disponibilità. Se api.refil.app non risponde, lo stesso percorso è servito da gasolina-smart-api.marcosnovo.workers.dev.
Uso intensivo o un'integrazione su misura? Scrivici.

Preferisci non programmare nulla?

Inserisci il widget «La benzina aumenta domani?» nel tuo sito, blog o forum con un <iframe>. Senza cookie né analisi, e con un link alla previsione.

Copia il codice del widget

Gli assistenti IA possono leggerla anche tramite il server MCP di Refil (strumento fuel_price_forecast).

Contatto: marcosnovodev@gmail.com