Torah API

Overview

Hebroni provides a free, static JSON API for every verse in the Torah — Genesis through Deuteronomy — plus illustrated breakdowns for hundreds of passages. No API key, no rate limits, no signup. All responses are static JSON files.

Base URL

Endpoints

Torah Verses

Illustrations

Book Codes

Example: Verse with illustration

GET https://hebroni.com/api/v1/torah/gen/25/27.json

{
  "ref":             "Genesis 25:27",
  "book":            "Genesis",
  "book_code":       "gen",
  "chapter":         25,
  "verse":           27,
  "he":              "וַיִּגְדְּלוּ הַנְּעָרִים וַיְהִי עֵשָׂו אִישׁ יֹדֵעַ צַיִד",
  "en":              "When the boys grew up, Esau was a skillful hunter, a man of the field...",
  "en_plain":        "The boys grew. Esau was a skillful hunter, a man of the field...",
  "url":             "https://hebroni.com/torah/reader/#gen/25/27",
  "illustration":    "https://hebroni.com/assets/media/JE1. Bereshit 25-27–28 — The Boys Grow, Two Ways.webp",
  "breakdown_url":   "https://hebroni.com/breakdowns/bereshit-25-27-28-two-ways/",
  "breakdown_title": "Two Ways"
}

Verse Response Fields

Field	Description
ref	Human-readable reference (e.g. "Genesis 25:27")
book	English book name
book_code	Short book code for API URLs
chapter	Chapter number
verse	Verse number
he	Hebrew text (Masoretic, fully voweled)
en	English translation — Authorized King James Version (1611)
en_plain	Modern plain-English — World English Bible (WEB, public domain)
url	Deep link to this verse in the Hebroni Torah Reader
illustration new	Illustration image URL — present when this verse has a linked breakdown
breakdown_url new	URL of the illustrated word-by-word breakdown for this passage
breakdown_title new	Short title of the breakdown

Example: Illustrations index

GET https://hebroni.com/api/v1/illustrations/index.json

Returns an array of 161 illustration records covering Genesis through Deuteronomy.

[
  {
    "id":            "bereshit-25-27-28-two-ways",
    "title":         "Two Ways",
    "title_he":      "וַיִּגְדְּלוּ הַנְּעָרִים",
    "ref":           "Genesis 25:27–28",
    "book":          "Genesis",
    "book_code":     "gen",
    "description":   "Esau is a hunter, Jacob a tent-dweller. One verse...",
    "image_url":     "https://hebroni.com/assets/media/JE1. Bereshit 25-27–28...",
    "breakdown_url": "https://hebroni.com/breakdowns/bereshit-25-27-28-two-ways/"
  },
  ...
]

Illustration Fields

Field	Description
id	Slug — matches the breakdown page URL path
title	English title of the illustrated breakdown
title_he	Hebrew heading used in the breakdown
ref	Verse range this breakdown covers (e.g. "Genesis 25:27–28")
book	English book name
book_code	Short book code
description	Plain-text description of the passage and breakdown
image_url	Absolute URL of the illustration image (.webp)
breakdown_url	Full URL of the Hebroni breakdown page

Usage Examples

JavaScript (fetch)

fetch('https://hebroni.com/api/v1/torah/gen/1/1.json')
  .then(r => r.json())
  .then(v => console.log(v.he, v.en_plain));

Python

import requests
v = requests.get('https://hebroni.com/api/v1/torah/gen/1/1.json').json()
print(v['he'], v['en_plain'])

curl

curl https://hebroni.com/api/v1/torah/gen/1/1.json

CORS

All API responses are served with CORS headers by GitHub Pages, so you can fetch them from any domain or browser context.

Attribution

If you use this API, please link back to hebroni.com — Hebroni Torah Reader. The Hebrew text is from the Masoretic tradition. The KJV is public domain (1611). The plain-English translation is the World English Bible (WEB), public domain.

Limits

No rate limits. These are static files — each request is just a CDN fetch. Be reasonable with batch requests (add small delays if fetching hundreds of verses programmatically).