Torah API

Overview

Hebroni provides a free, static JSON API for every verse in the Torah — Genesis through Deuteronomy. No API key, no rate limits, no signup. All responses are static JSON files served from GitHub Pages.

Base URL

Endpoints

Book Codes

Example: Genesis 1:1

GET https://swrthy.com/api/v1/torah/gen/1/1.json

{
  "ref":      "Genesis 1:1",
  "book":     "Genesis",
  "book_code": "gen",
  "chapter":  1,
  "verse":    1,
  "he":       "בְּרֵאשִׁית בָּרָא אֱלֹהִים אֵת הַשָּׁמַיִם וְאֵת הָאָרֶץ׃",
  "en":       "In the beginning God created the heavens and the earth.",
  "en_plain":  "In the beginning, God created the heavens and the earth.",
  "url":      "https://swrthy.com/torah/reader/#gen/1/1"
}

Response Fields

Field	Description
ref	Human-readable reference (e.g. "Genesis 1:1")
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

Usage Examples

JavaScript (fetch)

fetch('https://swrthy.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://swrthy.com/api/v1/torah/gen/1/1.json').json()
print(v['he'], v['en_plain'])

curl

curl https://swrthy.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 swrthy.com/hebrew — 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).