Kezdőlap › Üzemanyagár API

Üzemanyagár API Románia

Integráld a benzin, a gázolaj és az LPG árait az alkalmazásodba egyetlen JSON API-n keresztül: rendszeresen gyűjtött adatok a hivatalos ármonitorból és közvetlen forrásokból, az árak korára vonatkozó információkkal, 90 napos előzményekkel és termékkész végpontokkal az adott körzetben lévő állomásokhoz, az útvonal menti állomásokhoz és a megyei aggregátumokhoz. Minden csomag 3 napos ingyenes próbával indul, és bármikor lemondhatod az ügyfélportálon.

1823 töltőállomás rendszeres adatgyűjtés 90 napos előzmények <100 ms válaszidő hivatalos ANPC forrás
Starter
19 € /hó
10 000 kérés/hó
  • Minden /api/v1/* végpont
  • Élő árak állomásokra, városokra, megyékre, hálózatokra
  • Árelőzmények akár 90 napra visszamenőleg
  • 3 napos próba — bármikor lemondhatod
Business
149 € /hó
1 000 000 kérés/hó
  • Minden /api/v1/* végpont
  • Élő árak állomásokra, városokra, megyékre, hálózatokra
  • Árelőzmények akár 90 napra visszamenőleg
  • 3 napos próba — bármikor lemondhatod
  • Elsőbbségi e-mail támogatás

Az előfizetéssel elfogadod az Általános Szerződési Feltételeket. Az API-hozzáférés azonnal indul, és amint használod a kulcsot, a már teljesített időszakra elveszíted a 14 napos elállási jogot — részletek.

Meglévő ügyfél? A vezérlőpultod — élő fogyasztás, grafikon, kulcs — ott találod a számlákat, a csomagváltást és a lemondást is (az „Előfizetés & számlák" gomb). A próbaidőszak alatt nem terhelünk semmit; ha az első 3 napon belül lemondod, egyáltalán nem fizetsz.

Quickstart

curl -H "X-Api-Key: pcro_live_..." \
  https://pretcarburant.ro/api/v1/preturi
{
  "status": "ok",
  "data": "2026-11-01",
  "total": 366,
  "preturi_lipsa": "null",
  "rezultate": [ { "oras": "Cluj-Napoca", "judet": "CJ",
                   "benzina": 10.01, "motorina": 10.86, "gpl": 4.71, ... } ],
  "retele": [ { "nume": "Petrom", "benzina": 10.01, "motorina": 10.86,
                "gpl": null, ... } ]
}

Hitelesítés az X-Api-Key fejléccel. Minden válasz tartalmazza az X-RateLimit-Limit és X-RateLimit-Remaining fejléceket.

A nálunk hiányzó ár null értékkel érkezik, nem 0-val — különben az átlagait olyan értékek húznák le, amelyek a kútnál nem léteznek. Ha a régi, 0-s formátumra van szüksége, adja hozzá a ?zeros=1 paramétert; a preturi_lipsa mező minden válaszban közli, melyik konvenció volt érvényben. Részletek a dokumentációban.

Miért a mi API-nk

  • Adatellenőrzés — árak a hivatalos ANPC ármonitorból és közvetlen forrásokból, kiugróérték-szűréssel és a bizonytalan rekordok megjelölésével.
  • Átlátható frissesség — minden ár mellett szerepel az elérhető dátum és az ellenőrzés állapota; az adatok kor szerint szűrhetők.
  • Termékkész végpontok — állomások adott körzetben, állomások egy útvonal mentén, megyei aggregátumok.
  • Számlázási gondok nélkül — Stripe-előfizetés, automatikus havi számla, bármikor lemondhatod.

Tartalmazott végpontok

VégpontLeírás
GET /api/v1/preturiLegalacsonyabb ár városonként + hálózati átlagárak
GET /api/v1/judete/<megye>Megyei szintű aggregátum
GET /api/v1/reteleÁtlagárak hálózatonként
GET /api/v1/statiiTöltőállomások koordinátákkal és árakkal (szűrők: márka, típus, lat/lon + sugár)
GET /api/v1/statie/<id>/istoricÁllomásonkénti előzmények (max 90 nap)
GET /api/v1/geocodeVárosnevek automatikus kiegészítése
POST /api/v1/traseu/customTöltőállomások egy A→B útvonal mentén

Teljes műszaki dokumentáció →

GYIK

Milyen gyakran frissülnek az árak?

Naponta többször gyűjtünk adatokat. A hálózatok régebbi jelentéseket is küldhetnek. A gyűjtés időpontja nem garantál frissen mért árat: ellenőrizd minden rekord dátumát és állapotát.

Van próbaidőszak?

Igen — 3 nap ingyen bármelyik csomagnál. Bármikor lemondható az ügyfélportálon.

Mi történik, ha túllépem a havi limitet?

HTTP 429 választ kapsz frissítési linkkel; a limit a naptári hónap első napján nullázódik.

Hogyan kapom meg a számlát?

A Stripe automatikusan e-mailben küldi a havi számlát; minden az ügyfélportálon intézhető.