API cen paliva v EU Online
Ceny paliva v zemích EU — průměry podle country, nejbližší stanice podle souřadnic nebo stanice poblíž hraničního přechodu. Agregováno z oficiálních národních cenových registrů a tržních dat.
GET https://nakordoni.eu/api/v1/data/fuel
— třída kvóty: cheap
| Parametr | Popis |
|---|---|
mode | country (default) | nearest | border. country = national average; nearest = stations near lat/lon; border = stations near a checkpoint |
country | Kód země ISO (volitelné) |
lat | Zeměpisná šířka (volitelné) |
lon | Zeměpisná délka (volitelné) |
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 | Kód jazyka |
limit | Max stations returned for mode=nearest/border (default 5) |
Pole odpovědi — uvnitř objektu data v obálce odpovědi. [] označuje seznam, takže data.items[].name je pole name každého prvku. Pole bývá null, chybí nebo je prázdný seznam, když pro něj nemáme hodnotu — zástupný údaj nedoplňujeme.
| Pole | Popis |
|---|---|
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"
🔑 Přihlaste se jako vývojář a vyzkoušejte tento endpoint naživo v sandboxu — 50 bezplatných testovacích volání denně. Přihlásit se