Bible & Torah API

Getting Started

The Bible & Torah API provides programmatic access to multiple Bible translations with powerful search capabilities, comprehensive Torah reading schedules across different traditions and variants, Hebrew text transliteration with multiple schemas, and access to biblical dictionaries including Strong's concordance and BDB lexicon.

1. Get an API Key

Request an API key by contacting the administrator or using the admin panel.

POST /v1/admin/keys
Content-Type: application/json

{
  "name": "My Application",
  "plan": "free",
  "description": "API key for my app"
}
                

2. Make Your First Request

# Bible API
curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.israpps.site/v1/verse?translation=KJV&reference=John+3:16

# Torah API (no key needed for traditions list)
curl https://api.israpps.site/v1/torah-readings/traditions

# Transliteration API
curl -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hebrew_text": "אֱלֹהִים", "schema_id": "biblical-academic"}' \
  https://api.israpps.site/v1/transliterate

# Dictionary API
curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.israpps.site/v1/dictionary/H1
                

Features

Multiple Translations

Access various Bible translations including KJV, NIV, and more with Strong's numbers support.

Full-Text Search

Powerful PostgreSQL full-text search with testament, book, and translation filters.

Strong's Concordance

Search by Strong's numbers to find original Greek/Hebrew word occurrences.

Torah Readings

Daily Torah readings across multiple traditions (Ashkenazi, Sephardi, Triennial, etc.)

Hebrew Transliteration

Convert Hebrew text to Latin characters using multiple transliteration schemas with caching.

Biblical Dictionaries

Access Strong's, BDB, and other lexicons with definitions, transliterations, and cross-references.

Bible API Endpoints

Public Endpoints No Auth Required

GET /health

Health check endpoint

curl https://api.israpps.site/health
# Response: OK
                    

GET /v1/translations

List all available Bible translations

curl https://api.israpps.site/v1/translations

GET /v1/stats

Get live statistics about cached data

curl https://api.israpps.site/v1/stats
# Response: {"verse_count": 274113, "translation_count": 11}
                    

Bible Endpoints Requires API Key

GET /v1/verse

Get verse(s) by natural reference

# Single verse
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.israpps.site/v1/verse?translation=KJV&reference=John+3:16"

# Verse range
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.israpps.site/v1/verse?translation=KJV&reference=John+3:16-18"

# Cross-chapter verse range
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.israpps.site/v1/verse?translation=KJV&reference=Psalms+72:1-77:20"
                    

GET /v1/bible/{translation}/{book}/{chapter}

Get entire chapter

curl -H "X-API-Key: YOUR_KEY" \
  https://api.israpps.site/v1/bible/KJV/John/3
                    

GET /v1/search

Full-text search with filters

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.israpps.site/v1/search?q=faith+hope+love&translation=KJV&limit=20"
                    

GET /v1/strongs/{code}

Search by Strong's concordance number

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.israpps.site/v1/strongs/G3956?translation=KJVPlus&limit=100"
                    

Torah Readings API New

Access Torah reading schedules across multiple traditions and variants. Powered by Hebcal for accurate holiday and date calculations.

Available Traditions

jewish_shabbat - Full Kriyah (7 aliyot on Shabbat)
jewish_weekday - Weekday readings (3 aliyot on Monday/Thursday)
jewish_triennial - Triennial cycle (3-year Torah reading schedule)

Available Variants

diaspora - Diaspora reading schedule
israel - Israel reading schedule

Public Endpoints No Auth Required

GET /v1/torah-readings/traditions

List all available Torah reading traditions and variants

curl https://api.israpps.site/v1/torah-readings/traditions

# Response includes all available traditions with their variants

Protected Endpoints Requires API Key

GET /v1/torah-readings

Get Torah reading for a specific date

# Required parameters
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.israpps.site/v1/torah-readings?date=2025-10-12&tradition=jewish_shabbat&variant=diaspora"

# With verse links (optional)
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.israpps.site/v1/torah-readings?date=2025-10-12&tradition=jewish_shabbat&variant=diaspora&include_verses=true"
                    

Query Parameters

Parameter	Required	Description
`date`	Yes	Date in YYYY-MM-DD format
`tradition`	No	Default: jewish_shabbat
`variant`	No	Default: diaspora
`include_verses`	No	Include links to Bible API verses (default: false)

Transliteration API New

Convert Hebrew text to Latin characters using multiple transliteration schemas. Supports single and batch transliteration with intelligent caching for fast responses.

Available Schemas

biblical-academic - Biblical Academic (SBL) transliteration standard
modern-hebrew - Modern Hebrew transliteration
phonetic - Phonetic transliteration
Additional schemas available via the schemas endpoint

Public Endpoints No Auth Required

GET /v1/transliteration/schemas

List all available transliteration schemas

curl https://api.israpps.site/v1/transliteration/schemas

# Response includes all available schemas with IDs and names

Protected Endpoints Requires API Key

POST /v1/transliterate

Transliterate Hebrew text to Latin characters

curl -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hebrew_text": "אֱלֹהִים",
    "schema_id": "biblical-academic"
  }' \
  https://api.israpps.site/v1/transliterate

# Response:
{
  "success": true,
  "hebrew_text": "אֱלֹהִים",
  "transliteration": "ʾĕlōhîm",
  "schema": {
    "id": "117e62d4-0703-4189-a5f8-e5115e0f8d4d",
    "name": "Biblical Academic (SBL)",
    "slug": "biblical-academic"
  },
  "cached": false,
  "response_time": 16
}
                    

POST /v1/transliterate/batch

Batch transliterate multiple Hebrew texts (max 50 entries)

curl -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entries": [
      {
        "hebrew_text": "אֱלֹהִים",
        "schema_id": "biblical-academic"
      },
      {
        "hebrew_text": "תּוֹרָה",
        "schema_id": "biblical-academic"
      }
    ]
  }' \
  https://api.israpps.site/v1/transliterate/batch

# Response includes array of results with success/failure status
                    

Request Parameters

Parameter	Required	Description
`hebrew_text`	Yes	Hebrew text to transliterate (non-empty string)
`schema_id`	Yes	Transliteration schema ID or slug (e.g., "biblical-academic")
`options`	No	Optional transliteration options (schema-specific)

Response Fields

Field	Type	Description
`success`	boolean	Whether the transliteration was successful
`hebrew_text`	string	Original Hebrew text
`transliteration`	string	Transliterated text in Latin characters
`schema`	object	Schema information (id, name, slug)
`cached`	boolean	Whether the result was retrieved from cache
`response_time`	integer	Response time in milliseconds

Dictionary API New

Access biblical dictionaries including Strong's concordance, Brown-Driver-Briggs Hebrew lexicon, and other reference materials. Look up words, find definitions, cross-references, and transliterations.

Available Dictionaries

Strong's Hebrew Dictionary - Hebrew lexicon with Strong's numbers
Strong's Greek Dictionary - Greek lexicon with Strong's numbers
Brown-Driver-Briggs (BDB) - Comprehensive Hebrew-English lexicon
Additional Lexicons - Various other biblical reference materials

Dictionary Endpoints Requires API Key

GET /v1/dictionaries

List all available dictionaries

curl -H "X-API-Key: YOUR_KEY" \
  https://api.israpps.site/v1/dictionaries

# Filter by language
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.israpps.site/v1/dictionaries?language=H"
                    

GET /v1/dictionary/{entryId}

Look up a dictionary entry by ID

# Look up Hebrew word
curl -H "X-API-Key: YOUR_KEY" \
  https://api.israpps.site/v1/dictionary/H1

# Look up Greek word
curl -H "X-API-Key: YOUR_KEY" \
  https://api.israpps.site/v1/dictionary/G1234
                    

GET /v1/dictionary/search

Full-text search across all dictionaries

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.israpps.site/v1/dictionary/search?query=love&language=G&limit=20"
                    

GET /v1/strongs/{code}

Get Strong's dictionary entry

curl -H "X-API-Key: YOUR_KEY" \
  https://api.israpps.site/v1/strongs/H1
                    

GET /v1/strongs/search

Search Strong's dictionary by word or definition

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.israpps.site/v1/strongs/search?query=love&language=G"
                    

POST /v1/dictionary/batch

Batch lookup for multiple dictionary entries

curl -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entry_ids": ["H1", "H430", "G1234"]
  }' \
  https://api.israpps.site/v1/dictionary/batch
                    

Admin Endpoints

POST /v1/admin/keys

Create new API key

GET /v1/admin/keys

List all API keys

DELETE /v1/admin/keys/{id}

Revoke API key

Code Examples

JavaScript / Node.js - Transliterate Hebrew Text

const response = await fetch(
  'https://api.israpps.site/v1/transliterate',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      hebrew_text: 'אֱלֹהִים',
      schema_id: 'biblical-academic'
    })
  }
);
const data = await response.json();
console.log(data.transliteration); // Output: ʾĕlōhîm
                

JavaScript / Node.js - Get Torah Reading

const response = await fetch(
  'https://api.israpps.site/v1/torah-readings?date=2025-10-12&tradition=jewish_shabbat&variant=diaspora',
  {
    headers: {
      'X-API-Key': 'YOUR_API_KEY'
    }
  }
);
const data = await response.json();
console.log(data.parashah.name);
console.log(data.aliyot.map(a => a.verse_range));
                

JavaScript / Node.js - Look Up Dictionary Entry

const response = await fetch(
  'https://api.israpps.site/v1/dictionary/H1',
  {
    headers: {
      'X-API-Key': 'YOUR_API_KEY'
    }
  }
);
const entry = await response.json();
console.log(entry.entry.headword);
console.log(entry.entry.definition);
console.log(entry.entry.transliteration);
                

Python - Batch Transliteration

import requests

response = requests.post(
    'https://api.israpps.site/v1/transliterate/batch',
    json={
        'entries': [
            {'hebrew_text': 'אֱלֹהִים', 'schema_id': 'biblical-academic'},
            {'hebrew_text': 'תּוֹרָה', 'schema_id': 'biblical-academic'}
        ]
    },
    headers={'X-API-Key': 'YOUR_API_KEY'}
)

results = response.json()
for result in results['results']:
    print(f"{result['hebrew_text']} → {result['transliteration']}")
                

Python - Torah Reading with Bible Verses

import requests

response = requests.get(
    'https://api.israpps.site/v1/torah-readings',
    params={
        'date': '2025-10-12',
        'tradition': 'jewish_shabbat',
        'variant': 'diaspora',
        'include_verses': True
    },
    headers={'X-API-Key': 'YOUR_API_KEY'}
)

reading = response.json()
for aliyah in reading['aliyot']:
    print(f"{aliyah['number']}: {aliyah['verse_range']}")
                

Python - Dictionary Lookup

import requests

response = requests.get(
    'https://api.israpps.site/v1/dictionary/H1',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)

entry = response.json()
print(f"Headword: {entry['entry']['headword']}")
print(f"Definition: {entry['entry']['definition']}")
print(f"Transliteration: {entry['entry']['transliteration']}")
                