API Precios de Combustible UE Online
Precios del combustible en los países de la EU — promedios por country, estaciones más cercanas por coordenadas, o estaciones cerca de un paso fronterizo. Agregados de registros nacionales oficiales de precios y datos de mercado.
GET https://nakordoni.eu/api/v1/data/fuel
— clase de cuota: cheap
| Parámetro | Descripción |
|---|---|
mode | country (default) | nearest | border. country = national average; nearest = stations near lat/lon; border = stations near a checkpoint |
country | Código de país ISO (opcional) |
lat | Latitud (opcional) |
lon | Longitud (opcional) |
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 | Código de idioma |
limit | Max stations returned for mode=nearest/border (default 5) |
Campos de la respuesta — dentro del objeto data del sobre de respuesta. [] indica una lista, así que data.items[].name es el campo name de cada elemento. Un campo es null, no aparece o es una lista vacía cuando no tenemos valor: nunca un marcador de posición.
| Campo | Descripción |
|---|---|
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"
🔑 Inicia sesión como desarrollador para probar este endpoint en vivo en el sandbox — 50 llamadas de prueba gratuitas al día. Iniciar sesión