Fuelis › Atviri duomenys

Atviri degalų kainų duomenys (API)

Nemokama, atvira Lietuvos degalų kainų API. 751 degalinių su paskelbtomis kainomis, adresais ir turimomis koordinatėmis. Naujausios gautos darbo dienų kainos (rinkinio data: 2026-10-23). JSON ir CSV. Be registracijos, be raktų, be limitų.

Kainų šaltiniai šiame rinkinyje: portal: 749, saurida: 2. Pagrindas — LEA duomenys; price_src pažymi naujesnę patikrintą operatoriaus kainą, kai ji naudojama. Rinkinio data (price_date) ir atskiro kainos įrašo laikas (price_updated) yra skirtingi.

Kodėl tai egzistuoja: LEA kainas skelbia viešai, bet portale ir „Power BI“ skydelyje — iš jų programiškai pasiimti duomenis nėra paprasta. Čia tie patys duomenys pateikiami stabilia, dokumentuota schema, kad juos galėtum tiesiog fetch-inti.

Galiniai taškai

URLKas taiDydis
/api/summary.jsonŠalies vidurkiai + pigiausia degalinė kiekvienam kurui. Pradėk nuo šito — botams ir valdikliams to paprastai užtenka.~1 KB
/api/prices.jsonVisos degalinės: tinklas, adresas, savivaldybė, koordinatės, trys kainos, atnaujinimo laikas.~168 KB
/api/prices.csvTas pats CSV — „Excel“, „Google Sheets“, R, pandas.~95 KB
/api/history.jsonDienos šalies min./vid./maks. nuo 2026-04-08 — grafikams ir tendencijoms.~30 KB
/feed.xmlRSS: kasdienė kainų santrauka.—

Visi failai atiduodami su Access-Control-Allow-Origin: *, tad juos gali kviesti tiesiai iš naršyklės.

Pavyzdžiai

Šiandienos vidurkiai (curl)

curl -s https://fuelis.lt/api/summary.json | jq '.national'

Pigiausias dyzelinas (JavaScript)

const r = await fetch("https://fuelis.lt/api/summary.json").then(r => r.json());
console.log(r.cheapest.diesel);

Šio 2026-10-23 rinkinio tikras atsakymo pavyzdys:

{
 "price": 2.109,
 "network": "UAB Baltic Petroleum",
 "address": "Kaunas, Minkovskių g. 132, 46245",
 "municipality": "Kauno m. sav."
}

Į „pandas“ (Python)

import pandas as pd
df = pd.read_csv("https://fuelis.lt/api/prices.csv")
print(df.groupby("municipality")["diesel_eur"].mean().sort_values().head())

Laukai (stations[])

LaukasTipasPaaiškinimas
networkstringĮmonė / tinklas, kaip nurodyta LEA.
addressstringOriginalus degalinės adresas iš LEA; išsaugomas šaltinio įrašų tapatumui.
municipalitystringSavivaldybė (pvz. Kauno m. sav.).
lat, lonnumberWGS-84. Daugumai — oficialios operatoriaus koordinatės; likusios geokoduotos.
petrol95, diesel, lpgnumber | nullEUR už litrą. null = degalinė to kuro neteikia arba kainos nepateikė.
price_updatedISO 8601Kainos šaltinio įrašo laikas; operatoriaus kainai tai gali būti jos surinkimo laikas. Tai nėra rinkinio sugeneravimo laikas.
price_srcstring | nullKainos šaltinis: portal, sharepoint arba naujesnė patikrinta operatoriaus kaina (saurida).
display_municipality, display_municipality_sourcestring | nullPatikslinta rodoma savivaldybė ir jos šaltinis, jei LEA klasifikacija skiriasi nuo patikrintos vietos. municipality išsaugo LEA klasifikaciją.
display_address, display_address_sourcestring | nullPasirenkamas patikslintas rodomas adresas ir jo šaltinis JSON rinkiniuose. Naudojamas tik kai abu laukai pateikti; address išsaugo originalų LEA adresą.
{
 "network": "UAB Baltic Petroleum",
 "address": "Naujoji Akmenė, V. Kudirkos g. 21A, 85145",
 "municipality": "Akmenės r. sav.",
 "lat": 56.318461,
 "lon": 22.885615,
 "petrol95": 1.949,
 "diesel": 2.189,
 "lpg": 0.91,
 "price_updated": "2026-10-23T09:23:01+03:00",
 "price_src": "portal",
 "display_municipality": null,
 "display_municipality_source": null,
 "display_address": null,
 "display_address_source": null
}

Atnaujinimo dažnis

LEA pateikia darbo dienų kainų rinkinius. Tikriname juos kelis kartus per dieną; tikslus naujo rinkinio paskelbimo laikas ir jo pasirodymo Fuelis vėlavimas nėra garantuojami. Savaitgaliais, per šventes ar dar negavus naujo rinkinio gali likti ankstesnės darbo dienos kainos. Vertinkite price_date ir kiekvieno įrašo price_updated. generated_utc žymi tik API failo paruošimo laiką.

Licencija ir nuorodos

Fuelis nemokamai, taip pat ir komerciniam naudojimui, siūlo savo išvalytą, geokoduotą, stabilios schemos rinkinį. Pirminiai šaltiniai — LEA ir atskiruose įrašuose pažymėti operatoriai. Šis rinkinio naudojimo pasiūlymas nėra nauja pirminių LEA ar operatorių kainų duomenų licencija.

Be garantijų. Duomenys teikiami tokie, kokie yra. Kainos degalinėje gali skirtis nuo paskelbtų LEA. Prieš pildamas — pasitikrink kolonėlėje.

Klausimai

Radai klaidą, reikia kito formato ar lauko? Rašyk per fuelis.lt kontaktų formą. Jei kuri kažką su šiais duomenimis — parodyk, mielai pasidalinsime.