Using HEBCAL Public APIs in JavaScript

If you are looking for a reliable Jewish calendaring system with all the essential features, then HEBCAL is exactly what you need. The HEBCAL calendar system is extremely versatile and includes powerful functionalities like synchronization with Google Calendar or iCalendar, as well as complex Hebrew date calculations. The good news is that HEBCAL also provides public APIs that allow you to easily integrate the calendar system into your website or mobile application.

HEBCAL Public APIs

HEBCAL provides several APIs that you can use to retrieve different data. These APIs are:

  • Hebrew Date Converter API: This API converts Gregorian dates to Hebrew dates and back. It also includes features for Islamic and Julian date conversion.

  • Jewish Holiday API: This API retrieves data on Jewish holidays.

  • Hebrew Calendar API: This API provides information about the Hebrew calendar, including sunrise and sunset times, parshat hashavua, and yahrzeit calculation.

  • Zmanim API: This API calculates zmanim (Jewish prayer times), including sunrise, sunset, and other important times of the day.

JavaScript Examples

Here are some examples of how you can use the HEBCAL public APIs in JavaScript:

Hebrew Date Converter API

fetch('https://www.hebcal.com/converter?cfg=json&gy=2021&gm=1&gd=1&g2h=1')
  .then(response => response.json())
  .then(data => console.log(data));

This code retrieves the Hebrew date for January 1st, 2021, using the Hebrew Date Converter API.

Jewish Holiday API

fetch('https://www.hebcal.com/holidays?cfg=json&year=2021&month=9')
  .then(response => response.json())
  .then(data => console.log(data));

This code retrieves the list of Jewish holidays for September 2021, using the Jewish Holiday API.

Hebrew Calendar API

fetch('https://www.hebcal.com/shabbat?cfg=json&lat=31.7777&lon=35.2324&tzid=Asia%2FJerusalem')
  .then(response => response.json())
  .then(data => console.log(data));

This code retrieves information on the upcoming Shabbat, including sunrise and sunset times, using the Hebrew Calendar API.

Zmanim API

fetch('https://www.hebcal.com/zmanim?cfg=json&lat=31.7777&lon=35.2324&tzid=Asia%2FJerusalem')
  .then(response => response.json())
  .then(data => console.log(data));

This code retrieves zmanim (Jewish prayer times), including sunrise, sunset, and other important times of the day, using the Zmanim API.

Conclusion

In this article, we have introduced the HEBCAL public APIs and provided some JavaScript code examples to demonstrate how to use them. With these examples, you can start integrating the HEBCAL calendar system into your website or mobile application.

Related APIs

Public APIs — A directory of free and public apis

Built by @mddanishyusuf