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
The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.
Example Response
Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded 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
Calls a real endpoint of this API. Replace any placeholder credentials with your own key.
const url = "https://www.hebcal.com/shabbat?cfg=json&geo=city&city=NYC";
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
Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.
Metadata Score Breakdown
Estimated from metadata — endpoint not independently tested
Metadata estimate · endpoint not independently tested
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.