Подача новин і флот NakBus тепер у партнерській панелі
Підключіть свій обліковий запис розробника до акаунту Nakordoni Partners з тією самою електронною поштою і керуйте новинами та своїм автобусним флотом (NakDriver / NakManager) там, із ролями команди. Ваші API-ключі, ендпоінти й застосунки залишаються без змін, а сторінки тут продовжують працювати. Відкрити Nakordoni Partners

← Усі ендпоінти

API цін на пальне в ЄС Online

Ціни на пальне в країнах EU — середні по country, найближчі станції за координатами або станції поблизу пункту пропуску. Агреговано з офіційних національних реєстрів цін та ринкових даних.

GET https://nakordoni.eu/api/v1/data/fuel — клас квоти: cheap

ПараметрОпис
modecountry (типово) | nearest | border. country = середнє по країні; nearest = АЗС поблизу lat/lon; border = АЗС біля пункту пропуску
countryISO-код країни (необов'язково)
latШирота (необов'язково)
lonДовгота (необов'язково)
radius_kmРадіус пошуку в км для mode=nearest (типово 30; аліас: radius)
ppidID пункту пропуску для 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.countryISO-2 country the averages belong to, with country_name in the requested language.
data.data.petrolNational 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.dieselNational average for diesel.
data.data.lpgNational average for LPG, in the country's own currency; lpg_eur is the same figure converted to EUR for cross-country comparison.
data.data.updatedDate the averages are from — daily or weekly depending on the source, never live.
data.data.trend_petrolup | down | null against the previous reading, and trend_diesel the same for diesel.
data.gradesOne 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_keysReturned 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.labelsLocalised 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"
🔑 Увійдіть як розробник, щоб протестувати цей ендпоінт наживо в пісочниці — 50 безкоштовних тестових викликів на день. Увійти

Оновлено