{
 "name": "European fuel prices API",
 "what": "Station-level fuel prices from the official open data of Spain, Italy and France, in one schema.",
 "why": "Each government publishes a different format, language, fuel naming and update cadence. This normalises them and keeps a daily history that cannot be rebuilt afterwards.",
 "endpoints": [
  "/v1/countries",
  "/v1/stations?country=ES",
  "/v1/prices?country=ES&date=YYYY-MM-DD",
  "/v1/summary?country=ES&date=YYYY-MM-DD",
  "/v1/history?country=ES&fuel=DIESEL",
  "/v1/nearby?lat=42.50&lon=1.53&radius_km=40&fuel=DIESEL (crosses borders)"
 ],
 "fuels": [
  "PETROL_95",
  "PETROL_95_E10",
  "PETROL_98",
  "DIESEL",
  "DIESEL_PREMIUM",
  "LPG",
  "CNG",
  "E85",
  "HVO"
 ],
 "sources": {
  "ES": "Ministerio para la Transición Ecológica (MINCOTUR), open REST",
  "IT": "Ministero delle Imprese e del Made in Italy, open CSV (IODL 2.0)",
  "FR": "data.economie.gouv.fr / prix-carburants (Licence Ouverte)"
 },
 "free": "One day, one country, without a key. Full history needs x-api-key."
}