Цени на горивата в страните от EU — средни стойности по country, най-близки станции по координати или станции близо до граничен пункт. Агрегирани от официални национални ценови регистри и пазарни данни.
GEThttps://nakordoni.eu/api/v1/data/fuel
— клас квота: cheap
Параметър
Описание
mode
country (по подразбиране) | nearest | border. country = средно за страната; nearest = бензиностанции близо до lat/lon; border = бензиностанции до граничен пункт
country
ISO код на държава (по избор)
lat
Географска ширина (по избор)
lon
Географска дължина (по избор)
radius_km
Радиус на търсене в км за mode=nearest (по подразбиране 30; псевдоним: radius)
ppid
ID на граничния пункт за mode=border (напр. id_13)
fuel_type
Незадължителен, за mode=nearest: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng (наличността варира според бензиностанцията/региона). Приемат се и местните названия от колонките — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — те се разпознават спрямо `country` (или, при продуктите по координати, спрямо държавата, в която попада точката), защото едно и също название не означава навсякъде един и същ вид: „95“ е E10 на датска, финландска, френска, британска, белгийска или нидерландска колонка и E5 на полска или германска. Отговорът връща `fuel_type` (каноничен), `fuel_type_requested` (както сте го въвели) и `fuel_type_local`. Название, което не можем да разпознаем, никога не се подменя с вид по подразбиране — отговорът се връща празен и го заявява. Пълна таблица с названията по държави: /api/v2/data/fuel-grades.
lang
Код на език
limit
Максимум бензиностанции за mode=nearest/border (по подразбиране 5)
Полета на отговора— вътре в обекта data в плика на отговора. [] означава списък, така че data.items[].name е полето name на всеки елемент. Поле може да е null, да липсва или да е празен списък, когато нямаме стойност — никога не подставяме заместител.
Поле
Описание
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.
Fuel prices across EU countries — country averages, nearest stations by coordinates, or stations near a border checkpoint. Aggregated from official national price registries and market data. A single-country answer carries a `grades` object mapping each price key (petrol, petrol95plus, petrol92, petrol98, diesel, lpg) to its canonical grade and to the local pump name for that country; the all-countries summary carries the canonical mapping only, as `grade_keys`.
GEThttps://nakordoni.eu/api/v2/data/fuel
— клас квота: cheap
Параметър
Описание
mode
country (по подразбиране) | nearest | border. country = средно за страната; nearest = бензиностанции близо до lat/lon; border = бензиностанции до граничен пункт
country
ISO код на държава за mode=country (PL, DE, AT, FR, ES, IT, PT, SI, LU, RO, DK, HR, HU, SK, UA, …)
lat
Географска ширина за mode=nearest
lon
Географска дължина за mode=nearest (псевдоним: lng)
radius_km
Радиус на търсене в км за mode=nearest (по подразбиране 30; псевдоним: radius)
ppid
ID на граничния пункт за mode=border (напр. id_13)
fuel_type
Незадължителен, за mode=nearest: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng (наличността варира според бензиностанцията/региона). Приемат се и местните названия от колонките — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — те се разпознават спрямо `country` (или, при продуктите по координати, спрямо държавата, в която попада точката), защото едно и също название не означава навсякъде един и същ вид: „95“ е E10 на датска, финландска, френска, британска, белгийска или нидерландска колонка и E5 на полска или германска. Отговорът връща `fuel_type` (каноничен), `fuel_type_requested` (както сте го въвели) и `fuel_type_local`. Название, което не можем да разпознаем, никога не се подменя с вид по подразбиране — отговорът се връща празен и го заявява. Пълна таблица с названията по държави: /api/v2/data/fuel-grades.
lang
Код на езика за етикетите
limit
Максимум бензиностанции за mode=nearest/border (по подразбиране 5)
Полета на отговора— вътре в обекта data в плика на отговора. [] означава списък, така че data.items[].name е полето name на всеки елемент. Поле може да е null, да липсва или да е празен списък, когато нямаме стойност — никога не подставяме заместител.
Поле
Описание
data.stations[]
One entry per physical station, nearest first — NOT one per price. Replaces v1 `data.data`. `limit` counts stations here.
data.stations[].id
Station id where the station index answered. Null on the legacy path, where the underlying id is a price row rather than a station — use station_ref there.
data.stations[].station_ref
Stable 12-char key for the physical station (name + position). Safe to key on in every case; `id` is not, and in v1 it repeated across the rows of one station.
data.stations[].prices
Grades at that station, keyed by canonical grade: price, currency (ISO 4217 — v1 sent the € glyph), currency_symbol, grade, local_name, label, updated_at, age_hours, stale.
data.stations[].prices.*.local_name
What a driver in THAT country calls the grade — Poland ON / Pb95 / Pb98, Ukraine ДП / А-95, Czechia Nafta, Hungary Gázolaj, Romania Motorină, Slovenia Dizel. 44 countries; full table at /api/v2/data/fuel-grades.
data.stations[].prices.*.updated_at
When that price last CHANGED, floored to the hour - not when we last polled. A quote that has held steady keeps the same value across refreshes, so a moving timestamp means a moving price and nothing else. Use age_hours/stale, not this field, to judge how recently the quote was confirmed.
data.stations[].prices.*.stale
True once a price is older than 48 h — one full refresh cycle missed. v1 gave you a timestamp and no way to tell a two-hour-old price from a two-week-old one in the same response.
data.stations[].grades
The grade keys present, and freshest_age_hours / stale roll up the station.
data.total_found
Stations matching inside the radius before `limit` was applied. v1 had no way to tell you there were more.
data.notices
Present only when a parameter was adjusted: param, requested, applied, reason. v1 clamped radius_km silently.
