PretCarburant.ro nyilvános API — REST v1

Programozott hozzáférés az aggregált romániai üzemanyagár-adatokhoz. Ugyanaz az adat, amit mi is használunk az oldalon, 2 óránként frissül, hitelesítés nélkül. Creative Commons BY 4.0 licenc — szabadon használható forrásmegjelöléssel.

Elérhető végpontok

Bázis URL: https://pretcarburant.ro/api/v1/. Az összes válasz JSON, Cache-Control: public, max-age=300 és Access-Control-Allow-Origin: * fejlécekkel a nyilvános végpontokon.

REST v1 végpontok
Végpont	Leírás	Korlát
`GET /api/v1/preturi`	Városonként aggregált árak (opcionális szűrő `?judet=CLUJ`)	Nincs (5 perces cache)
`GET /api/v1/preturi/minime`	Országos minimum/átlag/maximum árak üzemanyagtípusonként	Nincs (5 perces cache)
`GET /api/v1/judete/<judet>`	Megyei szintű aggregált átlagár (pl. `/api/v1/judete/CLUJ`)	1 kérés/hét/IP
`GET /api/v1/retele`	Figyelt hálózatok márkaszintű átlagárakkal	1 kérés/hét/IP
`GET /api/v1/statii`	Állomáslista koordinátákkal, márkával, árakkal (szűrők: `?brand=`, `?tip=`, `?lat=&lon=&raza=` a sugáron belüli állomásokhoz, km)	1 kérés/hét/IP
`GET /api/v1/statie/<station_id>/istoric`	Egy állomás árelőzménye	1 kérés/hét/IP

cURL példák

Városonként aggregált árak

curl -s https://pretcarburant.ro/api/v1/preturi | jq '.rezultate[0]'

Megye szerinti szűrés

curl -s "https://pretcarburant.ro/api/v1/preturi?judet=CLUJ" | jq '.rezultate'

Országos minimum árak

curl -s https://pretcarburant.ro/api/v1/preturi/minime | jq '.preturi'

Petrom állomások gázolajjal

curl -s "https://pretcarburant.ro/api/v1/statii?brand=petrom&tip=motorina_standard" | jq '.statii | length'

Állomások 10 km-es sugárban (lat/lon)

curl -s "https://pretcarburant.ro/api/v1/statii?lat=46.77&lon=23.62&raza=10" | jq '.total'

Megyei átlagár

curl -s https://pretcarburant.ro/api/v1/judete/CLUJ | jq

Korlátok és AI bot szabályok

Anonim felhasználóknál a korlátozott végpontokon (/retele, /statii, /istoric) 1 kérés/hét/IP a limit. A /preturi és /preturi/minime végpontok limit nélküliek (5 perces cache).

Az AI asszisztensek (ChatGPT, Claude, Perplexity, Gemini, Bing Copilot stb.) explicit User-Agent fehérlistán vannak. Ők a heti limit helyett 60 kérés/perc/IP cappal férnek hozzá, hogy közvetlenül idézhessék az adatainkat. Felismert UA-k: GPTBot, ChatGPT-User, OAI-SearchBot, ClaudeBot, anthropic-ai, PerplexityBot, Google-Extended, Googlebot, Applebot-Extended, Bytespider, Meta-ExternalAgent, CCBot, MistralAI, cohere-ai, YouBot, DiffBot, Bravebot és mások.

Válaszformátum

Minden válasz közös szerkezete:

{
  "status": "ok",
  "data": "2026-05-07",
  "rezultate": [...]
}

Hiba esetén:

{
  "status": "error",
  "message": "Rate limit: 1 kérés hetente...",
  "retry_after_seconds": 543210
}

Licenc és forrásmegjelölés

Az adatok Creative Commons BY 4.0 licenc alatt vannak közzétéve. Szabadon felhasználhatók kereskedelmi és nem kereskedelmi célokra is, látható forrásmegjelöléssel: „Forrás: PretCarburant.ro (https://pretcarburant.ro)".

A teljes adatállomány Zenodo DOI-val is elérhető: 10.5281/zenodo.19560194. A szervezet azonosítója a Wikidatán: Q139285387.

Kereskedelmi / nagy volumenű hozzáférés

Az ingyenes CC-BY 4.0 szint változatlan marad: 1 kérés/hét/IP a korlátozott végpontokon, látható forrásmegjelöléssel. Nem zárjuk le és nem plafonáljuk — a nyilvános adat nyilvános marad.

Fuvarozási/futár-/taxi-flották, szerkesztőségek, biztosítók és más nagy adatigényű felhasználók számára dedikált kereskedelmi csomagot kínálunk fix havi díjért:

Magas limitek — heti korlát nélkül, integrációnként egyeztetett áteresztőképesség (ERP/TMS, belső dashboard, szerkesztőségi újraközlés).
SLA — szerződésben garantált rendelkezésre állás és adatfrissesség, prioritásos támogatással.
Kiterjesztett felhasználási jogok — belső kereskedelmi termékekhez nincs CC-BY forrásmegjelölési kötelezettség, opcionális történeti pillanatképek és bulk export.

A díj a volumen és a felhasználási eset szerint kerül megállapításra. Kérjen kereskedelmi ajánlatot

Verziótörténet

v1.0 (2026-04-01) — első 5 nyilvános végpont; 5 perces cache; nyitott CORS.
v1.1 (2026-04-14) — bot UA fehérlista AI asszisztenseknek; per-IP 60 kérés/perc cap.
v1.2 (2026-05-07) — formális nyilvános dokumentáció a /api címen (RO/EN/HU).

Kapcsolat és hibajelentés

Email: contact@pretcarburant.ro. Technikai hibákhoz vagy feature kérésekhez tegyen „[API]" előtagot a tárgyba. Munkanapokon 48 órán belül válaszolunk.

Felelős nyilvánosságra hozatal biztonsági problémák esetén: lásd /.well-known/security.txt.