📖 Bible & Torah API

Comprehensive RESTful API for Bible Access, Search & Torah Readings

62,207

Verses Cached

2

Translations

📅

Torah Readings

⚡

Lightning Fast

Getting Started Bible API Torah API OpenAPI Spec GitHub

Getting Started

The Bible & Torah API provides programmatic access to multiple Bible translations with powerful search capabilities, plus comprehensive Torah reading schedules across different traditions and variants.

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

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.)

⚡ In-Memory Caching

Lightning-fast responses with intelligent caching of frequently accessed data.

🔐 API Key Auth

Secure access with API key authentication and usage tracking.

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

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" # Response structure: { "date": "2025-10-12", "hebrew_date": "20 Tishrei 5786", "tradition": { "key": "jewish_shabbat", "name": "Jewish - Shabbat" }, "variant": { "key": "diaspora", "name": "Diaspora" }, "parashah": { "name": "Bereishit", "is_holiday": false }, "aliyot": [ { "number": "1", "type": "torah", "book": "Genesis", "start_chapter": 1, "start_verse": 1, "end_chapter": 1, "end_verse": 5, "verse_range": "Genesis 1:1-1:5", "verse_count": 5, "link_to_verses": "https://api.israpps.site/v1/verse?translation=KJV&reference=Genesis+1:1-5" } ], "metadata": { "hebrew_year": 5786, "hebrew_month": 7, "hebrew_day": 20 } }

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)

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 - Get Torah Reading

const response = await fetch( 'https://api.israpps.site/v1/torah-readings?date=2025-10-12&tradition=jewish_shabbat&variant=diaspora&include_verses=true', { 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));

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']}")