Naptár API

Ingyenes, csak olvasható JSON API névnapokhoz, ünnepnapokhoz, zászlós napokhoz, holdfázishoz és hetek sorszámához. Nincs kulcs, nincs regisztráció. Az API annak a naptárnak az adataival válaszol, amelynek a címére a kérést küldöd.

https://magyarnaptar.app/api/v1

Végpontok

GET /api/v1/today
Minden a mai napról.
GET /api/v1/date/2026-12-06
Egy adott nap ÉÉÉÉ-HH-NN formában.
GET /api/v1/name-day/Anna
Mikor van egy név névnapja idén és jövőre.

A válasz mezői

date: ISO dátum, ÉÉÉÉ-HH-NN.
weekday: A hét napjának neve a helyi nyelven.
weekNumber: A hét sorszáma az ISO 8601 szerint, 1 és 53 között.
nameDay: Az aznap névnapjukat ünneplő nevek.
holidays: Ünnepnapok, mindegyik névvel és azonosítóval.
flagDays: Hivatalos zászlós napok, mindegyik névvel és azonosítóval.
moon: A holdfázis és a megvilágított rész aránya.

Példaválasz

A naptár élő válasza mára:

{
  "locale": "hu",
  "date": "2026-11-05",
  "weekday": "csütörtök",
  "weekNumber": 45,
  "nameDay": {
    "names": [
      "Imre"
    ]
  },
  "holidays": [],
  "flagDays": [],
  "moon": {
    "phase": "waningCrescent",
    "illumination": 0.184
  }
}

Kéréskorlát

IP-címenként legfeljebb 60 kérés percenként. A válaszok egy óráig gyorsítótárban maradnak, így a legtöbb alkalmazás sosem éri el a korlátot. A korlát túllépésekor az API 429-es kódot és Retry-After fejlécet ad vissza.

Feltételek

Ingyen használhatod alkalmazásokban, weboldalakon és hobbiprojektekben. A Magyar naptár oldalára mutató hivatkozásnak örülünk, de nem kötelező. Az adatok változhatnak, ezért minden választ pillanatképként kezelj.