Datos abiertos: la API de la previsión de Refil

La Previsión Refil —si el combustible va a subir o a bajar— es un dato abierto: una API pública, sin clave ni registro, con licencia CC BY 4.0. Úsala en tu medio, tu blog, tu foro o tu asistente, citando la fuente.

Qué devuelve

Una petición GET devuelve, para cada país o para el que pidas, el veredicto vigente de la Previsión Refil y el marcador público de aciertos:

• verdict: up (sube), down (baja) o none. none no significa «no sube»: significa que hoy no hay ninguna señal pública.
• signal: la dirección, el día objetivo (for_date, UTC), cuándo caduca (expires_at), en qué se apoya (basis.layer: calendario, noticias, crudo o detector) y la cifra (delta) en la escala y la unidad del país (cts/L, øre/L…); sin cifra si la fuente no la conoce.
• confirmation y last_hit: lo que pasó después, el último movimiento confirmado y el último acierto.
• accuracy: el marcador público por capa, con la misma puerta que la web: una capa sólo publica números con al menos 30 avisos evaluados.
• computed_at y fuel_scope: cuándo se calculó, y que la señal es del país —la cesta de combustibles de cabecera—, no de un combustible concreto.

Ejemplo

Todos los países, o uno solo con ?country=ES:

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

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

Respuesta abreviada, con valores de ejemplo.

Licencia

Creative Commons Atribución 4.0 (CC BY 4.0): puedes copiar, redistribuir y usar los datos, también con fines comerciales, siempre que cites la fuente. CC BY 4.0

Cómo atribuir

La atribución es obligatoria e incluye un enlace visible a Refil, sin nofollow. Basta con una línea junto al dato:

Fuente: <a href="https://refil.app/datos-abiertos/">Previsión de Refil</a> (CC BY 4.0)

Fuente: Previsión de Refil (CC BY 4.0)

Si lo cita un asistente o un agente: debe nombrar «Refil — refil.app» y enlazar la página «¿sube mañana?» del mercado.

Límites y buenas prácticas

• La respuesta se cachea unos minutos: no hace falta consultarla más de una vez cada diez.
• Es una previsión, no una garantía: el marcador accuracy dice cuánto acierta.
• Los países sin previsión posible (Suiza no tiene precios oficiales) devuelven 404.
• Servicio gratuito y sin garantía de disponibilidad. Si api.refil.app no responde, la misma ruta está en gasolina-smart-api.marcosnovo.workers.dev.
• ¿Uso intensivo o una integración a medida? Escríbenos.

¿Prefieres no programar nada?

Inserta el widget «¿Sube mañana?» en tu web, blog o foro con un <iframe>. Sin cookies ni analítica, y con enlace a la previsión.

Copiar el código del widget

Los asistentes de IA también la leen por el servidor MCP de Refil (herramienta fuel_price_forecast).

Contacto: marcosnovodev@gmail.com