API Prezzi dei Carburanti UE Online
Prezzi del carburante nei paesi EU — medie per country, stazioni più vicine per coordinate, o stazioni vicino a un valico di frontiera. Aggregati dai registri nazionali ufficiali dei prezzi e dai dati di mercato.
GET https://nakordoni.eu/api/v1/data/fuel
— classe di quota: cheap
| Parametro | Descrizione |
|---|---|
mode | country (default) | nearest | border. country = national average; nearest = stations near lat/lon; border = stations near a checkpoint |
country | Codice paese ISO (opzionale) |
lat | Latitudine (opzionale) |
lon | Longitudine (opzionale) |
radius_km | Search radius km for mode=nearest (default 30; alias: radius) |
ppid | Checkpoint ID for mode=border (e.g. id_13) |
fuel_type | Optional, for mode=nearest: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng (availability varies by station/region). Local pump names are accepted as well — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — resolved against `country` (or, for coordinate products, the country the point falls in), because the same wording is not the same grade everywhere: “95” is E10 at a Danish, Finnish, French, British, Belgian or Dutch pump and E5 at a Polish or German one. The response echoes `fuel_type` (canonical), `fuel_type_requested` (as you typed it) and `fuel_type_local`. A name we cannot place is never swapped for a default grade — the answer comes back empty and says so. Full table of names per country: /api/v2/data/fuel-grades. |
lang | Codice lingua |
limit | Max stations returned for mode=nearest/border (default 5) |
Campi della risposta — all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.
| Campo | Descrizione |
|---|---|
data.data.country | ISO-2 country the averages belong to, with country_name in the requested language. |
data.data.petrol | National average for 95-octane petrol, in data.data.currency. petrol98 is the 98-octane average, petrol92 the 92-octane one and petrol95plus the additive-enhanced 95 — each is null where the country does not report it. |
data.data.diesel | National average for diesel. |
data.data.lpg | National average for LPG, in the country's own currency; lpg_eur is the same figure converted to EUR for cross-country comparison. |
data.data.updated | Date the averages are from — daily or weekly depending on the source, never live. |
data.data.trend_petrol | up | down | null against the previous reading, and trend_diesel the same for diesel. |
data.grades | One entry per price key above: grade (our canonical code), local_name (what a driver in that country calls it) and premium. Additive — the price keys themselves are unchanged. |
data.grade_keys | Returned instead of grades when you ask for every country at once: the price key → canonical grade mapping only, without the per-country local names. |
data.labels | Localised UI strings for the keys above — for rendering, not data. |
curl "https://nakordoni.eu/api/v1/data/fuel?country=PL" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Accedi come sviluppatore per provare questo endpoint dal vivo nella sandbox — 50 chiamate di prova gratuite al giorno. Accedi