A forrásmegjelölés minden csomagban kötelezőAttribution is required on every plan
Ez érvényes a próbaidőszakra, a fizetős csomagokra és az Enterprise-ra is: minden alkalmazás, weboldal vagy termék, amely ennek az API-nak az adatait mutatja, jól láthatóan feltünteti a „Data: Forgalom Most” szöveget, hivatkozással a forgalommost.hu oldalra. Másolható formában:The same applies on the trial, the paid plans and Enterprise: every app, website or product that shows data from this API displays “Data: Forgalom Most” clearly, with a link to forgalommost.hu. Ready to copy:
Data: <a href="https://forgalommost.hu">Forgalom Most</a>
Emellett megmarad az eredeti források megjelölése is a válaszban (meta.sources és minden bejelentés source mezője). Az Útinform esetében ez: „Forrás: Magyar Közút Nonprofit Zrt. (Útinform)”, a CC BY 4.0 licenc megnevezésével.The original source credits in the response must also be kept (meta.sources and the source field of each report). For Útinform that is “Forrás: Magyar Közút Nonprofit Zrt. (Útinform)”, naming the CC BY 4.0 licence.
Első lépésekGetting started
Hozz létre lent egy próbakulcsot, és tedd a kérés végére. Nyisd meg böngészőben a kulcsoddal a végén, és azonnal adatot kapsz:Create a trial key below and add it to the request. Opened in a browser with your key at the end, this returns data straight away:
https://forgalommost.hu/api/v1/incidents?road=m1&type=utfelujitas&key=A_KULCSOD
A válasz JSON. Térképhez add hozzá a &format=geojson paramétert. Kódban a kulcsot inkább fejlécben küldd:The response is JSON. For a map, add &format=geojson. In code, the key is better sent in a header:
curl -H "X-API-Key: A_KULCSOD" "https://forgalommost.hu/api/v1/incidents?county=pest-varmegye&type=lezaras"
A kulcsThe key
Minden kéréshez kulcs kell. Az itt létrehozott kulcs próbakulcs: az első kéréstől számítva 5 napig érvényes, óránként 120 kéréssel, hogy kipróbálhasd, illik-e az API a projektedhez. Utána az alábbi csomagok egyikére lesz szükséged.Every request needs a key. The key you create here is a trial key: it is valid for 5 days from the first request, at 120 requests an hour, so you can check whether the API suits your project. After that you need one of the plans below.
Nevet, e-mail-címet és célt három okból kérünk: hogy szólhassunk, ha egy hivatalos forrás leáll; hogy értsük, mi hiányzik még az API-ból; és mert egy visszavonható kulcs mindenkit megvéd egy elszabadult ciklustól.We ask for a name, email and purpose for three reasons: to warn you when an official source goes down; to understand what the API is still missing; and because a key that can be revoked protects everyone from a runaway loop.
CsomagokPlans
A szolgáltatáshoz való hozzáférésért fizetsz: a kérésekért, a limitekért és a támogatásért. Maguk az adatok az őket közzétevő hatóságokéi, és az ő feltételeik vonatkoznak rájuk; a forrásmegjelölésüknek meg kell maradnia.What you pay for is access to the service: the queries, the limits and the support. The data itself belongs to the authorities that publish it and stays under their licences; their credits must be kept.
PróbaTrial
Bárkinek, hogy kipróbálja, megfelel-e az APIFor anyone, to check whether the API fits
IngyenesFree
5 nap5 days
- 5 nap az első kéréstől5 days from the first request
- Óránként 120 kérés120 requests an hour
- Kötelező forrásmegjelölésAttribution required
SzemélyesPersonal
Magán- vagy kis projektek számottevő bevétel nélkülPrivate or small projects without significant revenue
15 €€15
havonta, áfávalper month, incl. VAT
- Naponta kb. 10 000 kérésAbout 10,000 requests a day
- MagyarországHungary
- Kötelező forrásmegjelölésAttribution required
ProfesszionálisProfessional
Kereskedelmi alkalmazások, hirdetéses weboldalak, céges belső használatCommercial apps, ad-funded websites, use within a company
79 €€79
havonta, áfávalper month, incl. VAT
- Naponta kb. 100 000 kérésAbout 100,000 requests a day
- E-mail, ha egy forrás leállEmail alert when a source goes down
- Kötelező forrásmegjelölésAttribution required
EnterpriseEnterprise
Flották, biztosítók, média, több ország, SLAFleets, insurers, media, several countries, SLA
Egyedi ajánlatOn request
Ajánlat a forgalom alapjánQuote based on volume
- Egyedi limitek és SLAAgreed limits and SLA
- Több ország a Roadscore-on keresztülSeveral countries through Roadscore
- SzerződésContract
Igénylés:Through Roadscore vagyor [email protected].
Így kapsz csomagot: írj a(z) [email protected] címre a projekted nevével és azzal, mire használod az adatokat. A megfelelő csomaggal és számlával válaszolunk, és átállítjuk a kulcsodat; a kulcs ugyanaz marad. A(z) Személyes és Professzionális csomagot havonta számlázzuk.How to get a plan: write to [email protected] with the name of your project and how you plan to use it. We reply with the right plan and an invoice, and switch your key over; it stays the same. The Personal and Professional plans are billed monthly.
Végpont és paraméterekEndpoint and parameters
A GET /api/v1/incidents azokat a bejelentéseket adja vissza, amelyeket a Forgalom Most térképe és oldalai mutatnak, ugyanabból a forrásból, ugyanabban a pillanatban. Minden paraméter elhagyható és kombinálható; több értéket vesszővel válassz el. Ismeretlen érték 400-as hibát ad a lehetséges értékekkel, soha nem csendben üres listát.GET /api/v1/incidents returns the reports that the map and the pages of Forgalom Most show, from the same source at the same moment. All parameters are optional and can be combined; separate multiple values with commas. An unknown value returns a 400 error listing the allowed values, never a silently empty list.
| ParaméterParameter | ÉrtékekValues | Mire valóPurpose |
|---|---|---|
road | m1, m30, 86, 5408 | Az út száma: autópálya (m1), főút (86) vagy mellékút (5408). ut= is működik.The road number: motorway (m1), main road (86) or secondary road (5408). Also ut=. |
county | budapest, bacs-kiskun-varmegye, baranya-varmegye … | Vármegye vagy Budapest, slugként, mint a /forgalom/pest-varmegye címben. varmegye= is működik. Mind a(z) 20:County or Budapest, as a slug as in /forgalom/pest-varmegye. Also varmegye=. All 20: budapest, bacs-kiskun-varmegye, baranya-varmegye, bekes-varmegye, borsod-abauj-zemplen-varmegye, csongrad-csanad-varmegye, fejer-varmegye, gyor-moson-sopron-varmegye, hajdu-bihar-varmegye, heves-varmegye, jasz-nagykun-szolnok-varmegye, komarom-esztergom-varmegye, nograd-varmegye, pest-varmegye, somogy-varmegye, szabolcs-szatmar-bereg-varmegye, tolna-varmegye, vas-varmegye, veszprem-varmegye, zala-varmegye. |
city | debrecen, szeged, miskolc … | Egy saját oldallal rendelkező város, mint a /forgalom/debrecen címben, a környező utakkal. varos= is működik.One of the cities with its own page, as in /forgalom/debrecen, with the roads around it. Also varos=. |
jaras | Győr, Siófok, Budapest XI. kerület | Bármelyik járás a székhelye nevével, vagy egy budapesti kerület (a kis- és nagybetű mindegy). Csak a határán belüli bejelentések. A válaszban a gemeente mező.Any járás (district) by its seat, or a Budapest kerület (case ignored). Only reports within its boundary. In the response, the gemeente field. |
type | baleset, akadaly, utfelujitas, lezaras, lezarva | A bejelentés fajtája, ékezettel vagy anélkül. Angolul is működik: accident, incident, roadworks, closure. A lezaras minden olyan bejelentést tartalmaz, ahol sáv, útpálya vagy út van lezárva; a lezarva csak a teljesen lezárt utakat.Type of report, with or without accents. English works too: accident, incident, roadworks, closure. lezaras covers every report with a closed lane, carriageway or road; lezarva only fully closed roads. |
closure | full, lanes, slip, layby, any | Mi van lezárva: full lezárt út vagy útpálya, lanes lezárt vagy szűkített sáv.What is closed: full is a closed road or carriageway, lanes a closed lane. |
status | active, scheduled | Most érvényes vagy tervezett.In force now or planned. |
severity | info, low, medium, high, critical | Súlyosság, mint a térképen.Severity, as on the map. |
source | utinform | Csak egy forrás bejelentései.Only reports from one source. |
bbox | 18.9,47.4,19.2,47.6 | Terület: minLon,minLat,maxLon,maxLat, WGS84.Area: minLon,minLat,maxLon,maxLat in WGS84. |
limit | 1 és 10000 között (1000)1 to 10000 (1000) | Legfeljebb ennyi bejelentés: előbb a most érvényesek, a legutóbb frissített elöl, utána a tervezettek, a legkorábbi elöl.At most this many reports: those in force first, most recently updated first, then planned ones, soonest first. |
format | json (alapértelmezett), geojsonjson (default), geojson | JSON listákhoz, GeoJSON térképekhez.JSON for lists, GeoJSON for maps. |
key | A_KULCSOD | A kulcsod, ha nem az X-API-Key vagy az Authorization: Bearer fejlécben küldöd.Your key, if not sent in the X-API-Key or Authorization: Bearer header. |
PéldaExample
Így néz ki egy API-válasz, rövidítve:The shape of an API response, shortened:
GET https://forgalommost.hu/api/v1/incidents?road=m1&type=utfelujitas&status=active&limit=1
{
"attribution": {
"text": "Data: Forgalom Most",
"url": "https://forgalommost.hu"
},
"meta": {
"count": 1,
"total": 18,
"generatedAt": "2026-10-27T09:58:19.015Z",
"licence": "Adatok: Forgalom Most (forgalommost.hu), a Roadscore-on keresztül, a sources mezőben felsorolt hivatalos forrásokból. A forrásmegjelölés minden csomagban kötelező, a Forgalom Most és minden eredeti forrás esetében.",
"sources": [
{
"id": "utinform",
"credit": "Forrás: Magyar Közút Nonprofit Zrt. (Útinform), a Nemzeti Hozzáférési Ponton keresztül",
"licence": "CC BY 4.0",
"licenceUrl": "https://creativecommons.org/licenses/by/4.0/deed.hu"
}
]
},
"incidents": [
{
"id": "hu-hu_UTINFORM_41111246",
"type": "roadworks",
"severity": "low",
"status": "active",
"lat": 47.627373,
"lon": 18.265932,
"title": "Sávlezárás · M1, Tata térsége",
"description": "Sávlezárás: M1, Tata térsége.\nLezárt sávok száma: 1.\nMegmaradó áteresztőképesség: 50%.\nBejelentő: Magyar Közút, MKIF-Komáromi APM autópályamérnökség.",
"descriptionEn": "Lane closure: M1, Tata area.\n1 lane restricted.\n50% of capacity remaining.\nReported by Magyar Közút (MKIF-Komáromi APM autópályamérnökség).",
"labelEn": "Lane closure",
"source": "utinform",
"sourceUrl": "https://utinform.hu",
"road": "M1",
"roadClass": "M",
"closure": "lanes",
"land": "komarom-esztergom-varmegye",
"gemeente": "Tata",
"authority": "Magyar Közút, MKIF-Komáromi APM autópályamérnökség",
"lanesRestricted": 1,
"capacityPct": 50,
"startedAt": "2026-09-29T21:30:00.000Z",
"endsAt": "2026-12-31T22:59:00.000Z",
"updatedAt": "2026-09-29T21:36:50.000Z"
}
]
}A válasz mezőiResponse fields
attribution: a szöveg és a hivatkozás, amelyet meg kell jelenítened. Ugyanez azX-Attributionfejlécben is.the text and link you must display. The same content comes in theX-Attributionheader.meta.countésandmeta.total: a válaszban lévő bejelentések és a találatok alimitelőtt.reports in the response and matches before thelimit.meta.generatedAt: mikor kértük le az adatokat.when the data was fetched.meta.sources: a válasz minden forrása, a forrásmegjelöléssel és a licenccel. Ezeknek meg kell maradniuk.every source in the response with its credit and licence. You must keep these.id,type,severity,status,lat,lon: azonosító, fajta (accident, incident, roadworks), súlyosság, most érvényes vagy tervezett, helyzet.ID, type (accident, incident, roadworks), severity, whether in force or planned, position.titleésanddescription: rövid cím és a leírás magyarul; adescriptionEnugyanez angolul, alabelEna fajta angolul.short title and the description in Hungarian;descriptionEnthe same in English,labelEnthe kind in English.road,roadClass: az út száma és osztálya (M autópálya vagy autóút, F főút, U mellékút).road number and class (M motorway or expressway, F main road, U secondary road).closure,lanesRestricted,capacityPct,windows: mi van lezárva, hány sáv, mennyi marad az áteresztőképességből, és meddig.what is closed, how many lanes, how much capacity remains, and until when.land,city,gemeente: vármegye (vagy Budapest) és város slugként, a járás a székhelye nevével vagy budapesti kerület (a koordinátákból számolva).county (or Budapest) and city as slugs, the járás by its seat or a Budapest kerület (computed from the coordinates).authority: ki jelentette be (a Magyar Közút melyik mérnöksége).who reported it (which Magyar Közút engineering office).startedAt,endsAt,updatedAt: kezdet, várható vége (az Útinform csak a napot adja meg: annak a napnak a vége), utolsó módosítás (ISO 8601, UTC).start, expected end (Útinform gives only the day: the end of that day), last change (ISO 8601, UTC).source,sourceUrl: a hivatalos forrás és a weboldala.the official source and its website.
Az érték nélküli mezők kimaradnak, nem null értéket kapnak.Fields without a value are left out rather than set to null.
HibákErrors
400: ismeretlen értékű paraméter; adetailfelsorolja a lehetséges értékeket.a parameter with an unknown value;detaillists the allowed ones.401: nincs kulcs.no key.402: lejárt a próbaidőszak. Csomagért írj a(z) [email protected] címre.the trial period has ended. For a plan, write to [email protected].403: a kulcsot visszavonták; adetailmegadja az okát.the key has been revoked;detailgives the reason.429: elérted a limitet; aretry-afterfejléc másodpercben adja meg a várakozási időt.limit reached; theretry-afterheader gives the wait in seconds.
A próbaidőszak alatt az X-API-Trial-Ends fejléc mutatja, mikor jár le.During the trial, the X-API-Trial-Ends header gives the end of the trial period.
LimitekLimits
Próba: óránként 120 kérés. Személyes: naponta kb. 10 000. Professzionális: naponta kb. 100 000. Enterprise: megállapodás szerint. A limit kulcsonként számít, nem IP-címenként, így egy sok felhasználós alkalmazást egyikük sem fékez le. Az X-RateLimit-Limit, X-RateLimit-Remaining és X-RateLimit-Reset fejléc mutatja, hol tartasz.Trial: 120 requests an hour. Personal: about 10,000 a day. Professional: about 100,000 a day. Enterprise: by agreement. Limits are counted per key, not per IP, so an app with many users is not held back by any one of them. The X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers show where you stand.
Az adatok nagyjából percenként frissülnek: 30 másodpercnél sűrűbben kérdezni nem hoz új bejelentést. A CORS nyitva van, így az API közvetlenül a böngészőből is hívható.The data is refreshed about once a minute: asking more often than every 30 seconds brings no new reports. CORS is open, so you can call the API straight from the browser.
Felhasználási feltételek és forrásmegjelölésTerms of use and attribution
Próbakulccsal vagy fizetős csomaggal egyaránt: érvényes kulcs vagy forrásmegjelölés nélkül erre az API-ra épülő terméket működtetni nem megengedett használat.On a trial key or a paid plan: running a product built on this API without a valid key or without attribution is not permitted use.
A forrásmegjelölés minden csomagban kötelezőAttribution is required on every plan
Ez érvényes a próbaidőszakra, a fizetős csomagokra és az Enterprise-ra is: minden alkalmazás, weboldal vagy termék, amely ennek az API-nak az adatait mutatja, jól láthatóan feltünteti a „Data: Forgalom Most” szöveget, hivatkozással a forgalommost.hu oldalra. Másolható formában:The same applies on the trial, the paid plans and Enterprise: every app, website or product that shows data from this API displays “Data: Forgalom Most” clearly, with a link to forgalommost.hu. Ready to copy:
Data: <a href="https://forgalommost.hu">Forgalom Most</a>
Emellett megmarad az eredeti források megjelölése is a válaszban (meta.sources és minden bejelentés source mezője). Az Útinform esetében ez: „Forrás: Magyar Közút Nonprofit Zrt. (Útinform)”, a CC BY 4.0 licenc megnevezésével.The original source credits in the response must also be kept (meta.sources and the source field of each report). For Útinform that is “Forrás: Magyar Közút Nonprofit Zrt. (Útinform)”, naming the CC BY 4.0 licence.
Az adatok az Útinformtól (Magyar Közút) származnak, és a Roadscore-on keresztül jutnak el hozzánk. A forrásmegjelölések, ahogy a szolgáltatók kérik:The data comes from Útinform (Magyar Közút) and reaches us through Roadscore. The credits, as the providers require them:
- Forrás: Magyar Közút Nonprofit Zrt. (Útinform), a Nemzeti Hozzáférési Ponton keresztül (CC BY 4.0)
Őszintén a lefedettségrőlHonest about coverage
Az API azt adja vissza, amit a hivatalos források közzétettek, nem azt, ami épp most történik az úton. A bejelentés nélküli út nem feltétlenül szabad út, csak olyan, amelyről senki nem tett közzé semmit. Az Útinform elsősorban útfelújításokat és forgalomkorlátozásokat közöl; dugókról nem ad adatot. Az adatok az Útinformtól (Magyar Közút) származnak, és az egész országos közúthálózatra kiterjednek: autópályák, autóutak, fő- és mellékutak.The API returns what the official sources have published, not what is happening on the road right now. A road with no report is not a clear road, just one nobody has published anything about. Útinform mostly publishes roadworks and traffic restrictions; it carries no congestion data. The reports come from Útinform (Magyar Közút) and cover the whole state road network: motorways, expressways, main and secondary roads.
Ha értesítéseket építesz rá, mondd el ezt a felhasználóidnak. És ne használd az API-t vészhelyzeti döntésekhez: vészhelyzetben hívd a 112-t.If you build alerts on it, tell your users so. And do not use the API for emergency decisions: in an emergency, call 112.
KapcsolatContact
Kérdés, csomag, elveszett kulcs vagy hiányzó forrás: [email protected]. Az útlezárások és az útfelújítások oldal ugyanazokat az adatokat mutatja, amelyeket az API visszaad.Questions, a plan, a lost key or a missing source: [email protected]. The closures and roadworks pages show the same data the API returns.