Skip to main content

Developer APIs

Our mission at is to increase awareness of Jewish holidays and to help Jews to be observant of the mitzvot. You can embed content directly onto your synagogue website with our JavaScript, JSON and RSS APIs.

Content on this site is licensed under a Creative Commons Attribution 4.0 International License. This means that you can use you are free to copy and redistribute the material in any medium or format as long as you give appropriate credit to

Technical notes:

  • Hebcal web APIs do not require registration or API keys
  • Rate-limiting is used to throttle clients who are sending too many API queries. You may receive a 429 “Too Many Requests” error if your client makes more than 90 requests in a 10-second window. Remember, this is a free service; please be polite and send batch API requests slowly over a longer period of time
  • If you’re building a JavaScript application, consider using @hebcal/core instead of web APIs for a faster user experience

Easy integrations

Our easy integrations require just a few HTML script tags and offer some simple customization.


Some integrations require editing JavaScript or use specialized file formats such as RSS and iCalendar.

  • Jewish Calendar – display a monthly Jewish calendar on your synagogue’s website using JavaScript
  • Shabbat Times WordPress widget – add Torah portion, candle lighting and havdalah times to your WordPress-powered site.
  • RSS feeds – integrate Hebrew date, Parsahat ha-Shavua, or candle lighting times into any content management system supporting RSS.
  • iCalendar feeds – calendar event feeds for many consumer calendar applications such as Google Calendar,, etc.

Advanced REST APIs

Hebcal’s REST APIs offer flexible access to date, calendar, holiday, Torah Reading and zmanim calculations. They are designed to make getting up and running with a new web or mobile app as simple as possible

Source Code

In addition to web APIs, Hebcal code is available in many programming languages, all freely available on GitHub

Open Source Judaism

Learn more about the Open Source Judaism movement.