Hebrew Calendar API
Overview
The Hebcal API provides free Jewish calendar data including Hebrew date conversions, Shabbat candle-lighting times, Jewish holidays, and weekly Torah portion readings. It requires no API key and accepts latitude/longitude for location-specific Shabbat times. Responses can be returned as JSON or iCal format.
Beginner Tip
No API key needed. For Shabbat times, use the /shabbat endpoint with a city parameter, e.g., https://www.hebcal.com/shabbat?cfg=json&geo=city&city=NYC. For date conversion, use the /converter endpoint.
Available Data
Example Response
{
"status": "success",
"data": {
"result": "Data from Hebrew Calendar",
"description": "Convert between Gregorian and Hebrew, fetch Shabbat and Holiday times, etc",
"timestamp": "2025-01-15T10:00:00Z"
}
} Field Reference
location.title Human-readable location name used for candle-lighting time calculations. items[].title Name of the event, e.g., "Candle lighting: 4:11pm" or "Parashat Vayigash". items[].date ISO 8601 date (or datetime) of the event. items[].category Event type: "candles", "havdalah", "holiday", or "parashat". items[].hebrew Hebrew-language name of the event or holiday. Implementation Example
const url = "https://www.hebcal.com/home/developer-apis";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Matrix Score Breakdown
Fully tested on Apr 5, 2026
Technical Specifications
Related Tags
Similar APIs
View All →Church Calendar
⭐ Beginner's PickChurch Calendar (calapi.inadiutorium.cz) is a free, no-auth REST API that returns the Roman Catholic liturgical calendar for any date or month.
Czech Namedays Calendar
⭐ Beginner's PickThe Czech Namedays Calendar API lets you look up the Czech or Slovak nameday (svátek) associated with a given first name, or find whose nameday falls on a specific date.
LectServe
⭐ Beginner's PickLectServe is a free REST API that returns Revised Common Lectionary readings — Scripture passages assigned to each Sunday and feast day used by many Protestant denominations.
Nager.Date
⭐ Beginner's PickNager.Date is a completely free, open-source REST API providing public holidays for over 90 countries with no API key required.
Namedays Calendar
⭐ Beginner's PickNamedays Calendar provides name day traditions for dozens of countries, letting you look up which names are celebrated on any given date.