API prețuri carburanți UE Online
Prețuri la combustibil în țările EU — medii pe country, cele mai apropiate stații după coordonate sau stații lângă un punct de trecere a frontierei. Agregate din registrele naționale oficiale de prețuri și date de piață.
GET https://nakordoni.eu/api/v1/data/fuel
— clasă de cotă: cheap
| Parametru | Descriere |
|---|---|
mode | country (default) | nearest | border. country = national average; nearest = stations near lat/lon; border = stations near a checkpoint |
country | Cod de țară ISO (opțional) |
lat | Latitudine (opțional) |
lon | Longitudine (opțional) |
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 | Cod de limbă |
limit | Max stations returned for mode=nearest/border (default 5) |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
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"
🔑 Autentifică-te ca dezvoltator pentru a testa acest endpoint live în sandbox — 50 de apeluri de test gratuite pe zi. Autentificare