Premier Tanach-Only Hebrew Search API

Version: 1.0.0
Contact: toraware@gmail.com

High-performance Tanach-only search API for precise, flexible Hebrew Bible queries. No Talmud, no other literature — 100% Tanach. Designed for developers, educators, students, and digital humanities projects needing advanced word or multi-word queries, including:

word or multi-word search
gematria
acronyms
equidistant Torah letters
geometric verse features
verse 'bookends'

Endpoint

POST /docs/api/search

Request Body (JSON)

Must be an array of 7 elements:

method: string — One of the supported methods (see below)
option1: integer or null — Depends on method
option2: integer or null — Depends on method
startNum: integer — Parsha/book start number (1–88)
endNum: integer — Parsha/book end number (1–88)
hitLimit: integer — Maximum results (1–9999)
query: string or number — Hebrew string or number depending on method

Default Parameters

startNum: Default is 1 (except qd, which requires 1)
endNum: Default is 88 (except qd, which requires 54)
hitLimit: Default is 100 (range: 1–9999)

Search Methods

ww – Word Search

Finds words matching a Hebrew string with letters in the order they appear.

option1 (required):

1 – word contains those letters in same order
2 – word is an exact match to user string
3 – word containing those letters bound
4 – word starts with those letters
5 – word ends with those letters

option2: Always null
query: Hebrew string

ph – Multi-word or Multi-string Search

Finds Hebrew words or strings in a verse, in same order.

option1:

1 – contains those strings
2 – exact match of the strings

option2:

3 – separable words
4 – adjacent words

query: Hebrew space-separated words or strings

be – Begin-End Verse Letters

Find verses that begin and end with specified letters.

option1 / option2: Always null
query: 2 Hebrew letters (exactly)

gm – Gematria Search

Find verses by numerical value.

option1:

1 – entire verse equals value
2 – successive verses that sum to value
3 – successive words in verse sum to value
4 – verse sum is a multiple of the value

option2: Always null
query: Hebrew words or an integer

qd – Equidistant Letter Search (Torah only)

Finds letters equidistant from each other in Torah.

option1:

1 – skip intervals 1–50
2 – skip intervals 51–100
3 – skip intervals 101–150
4 – skip intervals 151–200
5 – skip intervals 201–250
6 – skip intervals 251–300
7 – custom skip interval specified in option2

option2: Custom skip interval if option1 = 7; otherwise null
startNum: Must be 1
endNum: Must be 54
query: Hebrew string

rst – Word Acronyms

Search letters in positions of successive words in a verse.

option1:

1 – first letter
2 – 2nd letter
3 – 3rd letter
4 – last letter
5 – 2nd to last
6 – 3rd to last

option2: Always null
query: Hebrew string

gp – Geometric Patterns

Find verses whose letters can be arranged as an equilateral triangle and/or a square.

option1:

1 – triangular
2 – square
3 – both

option2 / query: Always null

rsp – Verse Acronyms

First or last letters of successive verses.

option1:

1 – first letters
2 – last letters

option2: Always null
query: Hebrew string

Response Format

{
  "results": [ ... ],
  "count": 123,
  "query": "your-query"
}

Parsha/Book Codes

Parsha or Book numbers range from 1 to 88 and include all of Tanach, from בראשית to דברי הימים ב.


  "1": "בראשית",
  "2": "נח",
  "3": "לך לך",
  "4": "וירא",
  "5": "חיי שרה",
  "6": "תולדות",
  "7": "ויצא",
  "8": "וישלח",
  "9": "וישב",
  "10": "מקץ",
  "11": "ויגש",
  "12": "ויחי",
  "13": "שמות",
  "14": "וארא",
  "15": "בא",
  "16": "בשלח",
  "17": "יתרו",
  "18": "משפטים",
  "19": "תרומה",
  "20": "תצוה",
  "21": "כי תשא",
  "22": "ויקהל",
  "23": "פקודי",
  "24": "ויקרא",
  "25": "צו",
  "26": "שמיני",
  "27": "תזריע",
  "28": "מצורע",
  "29": "אחרי מות",
  "30": "קדושים",
  "31": "אמור",
  "32": "בהר",
  "33": "בחקתי",
  "34": "במדבר",
  "35": "נשא",
  "36": "בהעלותך",
  "37": "שלח",
  "38": "קרח",
  "39": "חקת",
  "40": "בלק",
  "41": "פנחס",
  "42": "מטות",
  "43": "מסעי",
  "44": "דברים",
  "45": "ואתחנן",
  "46": "עקב",
  "47": "ראה",
  "48": "שופטים",
  "49": "כי תצא",
  "50": "כי תבוא",
  "51": "נצבים",
  "52": "וילך",
  "53": "האזינו",
  "54": "וזאת הברכה",
  "55": "יהושע",
  "56": "ספר שופטים",
  "57": "שמואל א",
  "58": "שמואל ב",
  "59": "מלכים א",
  "60": "מלכים ב",
  "61": "תהילים",
  "62": "ישעיה",
  "63": "ירמיה",
  "64": "יחזקאל",
  "65": "הושע",
  "66": "יואל",
  "67": "עמוס",
  "68": "עובדיה",
  "69": "שיר השירים",
  "70": "אסתר",
  "71": "יונה",
  "72": "מיכה",
  "73": "נחום",
  "74": "חבקוק",
  "75": "צפניה",
  "76": "חגי",
  "77": "זכריה",
  "78": "מלאכי",
  "79": "קהלת",
  "80": "איכה",
  "81": "משלי",
  "82": "רות",
  "83": "איוב",
  "84": "דניאל",
  "85": "עזרא",
  "86": "נחמיה",
  "87": "דברי הימים א",
  "88": "דברי הימים ב"