Données ouvertes : l'API de la prévision Refil

La prévision Refil — le carburant va-t-il monter ou baisser — est une donnée ouverte : une API publique, sans clé ni inscription, sous licence CC BY 4.0. Utilisez-la dans votre média, votre blog, votre forum ou votre assistant, en citant la source.

Ce qu'elle renvoie

Une requête GET renvoie, pour chaque pays ou pour celui que vous demandez, le verdict en cours de la prévision Refil et son taux de réussite public :

• verdict : up (hausse), down (baisse) ou none. none ne veut pas dire « pas de hausse » : il n'y a simplement aucun signal public aujourd'hui.
• signal : la direction, le jour visé (for_date, UTC), l'expiration (expires_at), ce sur quoi il repose (basis.layer : calendrier, actualités, pétrole brut ou détecteur) et l'ampleur (delta) dans l'échelle et l'unité du pays (cts/L…) ; sans chiffre si la source ne le connaît pas.
• confirmation et last_hit : la suite — le dernier mouvement confirmé et la dernière prévision réussie.
• accuracy : le taux de réussite public par couche, avec le même seuil que le site : une couche ne publie de chiffres qu'à partir de 30 alertes évaluées.
• computed_at et fuel_scope : le moment du calcul, et le fait que le signal est par pays — le panier des carburants phares — et non par carburant.

Exemple

Tous les pays, ou un seul avec ?country=FR :

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

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

Réponse abrégée, avec des valeurs d'exemple.

Licence

Creative Commons Attribution 4.0 (CC BY 4.0) : vous pouvez copier, redistribuer et utiliser les données, y compris à des fins commerciales, à condition de citer la source. CC BY 4.0

Comment citer la source

L'attribution est obligatoire et comprend un lien visible vers Refil, sans nofollow. Une ligne à côté de la donnée suffit :

Source : <a href="https://refil.app/fr/donnees-ouvertes/">Prévision Refil</a> (CC BY 4.0)

Source : Prévision Refil (CC BY 4.0)

Si un assistant ou un agent la cite : il doit nommer « Refil — refil.app » et lier la page « le carburant augmente-t-il demain ? » du marché.

Limites et bonnes pratiques

• La réponse est mise en cache quelques minutes : inutile de l'interroger plus d'une fois toutes les dix.
• C'est une prévision, pas une garantie : accuracy dit à quelle fréquence elle tombe juste.
• Les pays sans prévision possible (la Suisse n'a pas de prix officiels) renvoient 404.
• Gratuit, sans garantie de disponibilité. Si api.refil.app ne répond pas, le même chemin est servi par gasolina-smart-api.marcosnovo.workers.dev.
• Usage intensif ou intégration sur mesure ? Écrivez-nous.

Vous préférez ne rien programmer ?

Intégrez le widget « Le carburant augmente-t-il demain ? » dans votre site, blog ou forum avec un <iframe>. Sans cookies ni analytique, et avec un lien vers la prévision.

Copier le code du widget

Les assistants d'IA peuvent aussi la lire via le serveur MCP de Refil (outil fuel_price_forecast).

Contact: marcosnovodev@gmail.com