Dados abertos: a API da previsão Refil

A Previsão Refil — se o combustível vai subir ou descer — são dados abertos: uma API pública, sem chave nem registo, com licença CC BY 4.0. Usa-a no teu meio, blogue, fórum ou assistente, citando a fonte.

O que devolve

Um pedido GET devolve, para cada país ou para o que pedires, o veredito em vigor da Previsão Refil e o marcador público de acertos:

• verdict: up (sobe), down (desce) ou none. none não quer dizer «não sobe»: quer dizer que hoje não há nenhum sinal público.
• signal: a direção, o dia-alvo (for_date, UTC), quando caduca (expires_at), em que se apoia (basis.layer: calendário, notícias, crude ou detetor) e a dimensão (delta) na escala e na unidade do país (cent/L…); sem valor se a fonte não o conhece.
• confirmation e last_hit: o que aconteceu depois — o último movimento confirmado e o último acerto.
• accuracy: o marcador público por camada, com a mesma porta do site: uma camada só publica números com pelo menos 30 avisos avaliados.
• computed_at e fuel_scope: quando foi calculado, e que o sinal é do país — o cabaz dos combustíveis de referência — e não de um combustível concreto.

Exemplo

Todos os países, ou só um com ?country=PT:

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

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

Resposta abreviada, com valores de exemplo.

Licença

Creative Commons Atribuição 4.0 (CC BY 4.0): podes copiar, redistribuir e usar os dados, também para fins comerciais, desde que cites a fonte. CC BY 4.0

Como atribuir

A atribuição é obrigatória e inclui uma ligação visível para a Refil, sem nofollow. Basta uma linha junto ao dado:

Fonte: <a href="https://refil.app/pt/dados-abertos/">Previsão Refil</a> (CC BY 4.0)

Fonte: Previsão Refil (CC BY 4.0)

Se a citar um assistente ou agente: deve nomear «Refil — refil.app» e ligar à página «Os combustíveis sobem amanhã?» do mercado.

Limites e boas práticas

• A resposta fica em cache alguns minutos: não é preciso consultá-la mais de uma vez em cada dez.
• É uma previsão, não uma garantia: accuracy diz quantas vezes acerta.
• Os países sem previsão possível (a Suíça não tem preços oficiais) devolvem 404.
• Gratuita e sem garantia de disponibilidade. Se api.refil.app não responder, o mesmo caminho é servido por gasolina-smart-api.marcosnovo.workers.dev.
• Uso intensivo ou uma integração à medida? Escreve-nos.

Preferes não programar nada?

Insere o widget «Os combustíveis sobem amanhã?» no teu site, blogue ou fórum com um <iframe>. Sem cookies nem análise, e com ligação à previsão.

Copiar o código do widget

Os assistentes de IA também a leem através do servidor MCP da Refil (ferramenta fuel_price_forecast).

Contacto: marcosnovodev@gmail.com