wideholy

TypeScript SDK for WideHoly — cross-religion scripture search, verse comparison, verse of the day, religious calendar, and commentary across 5 world religions. Access 236,866 scripture records spanning Christianity (124K verses), Islam (31K ayahs), Judaism (69K verses), Hinduism (6,800 verses), and Buddhism (5,326 texts) through a unified, zero-dependency API client.

Built on the WideHoly platform, which aggregates scripture data from 5 religion-specific sites — WideBible, WideQuran, WideTorah, WideGita, and WideSutra — into a single cross-religion hub with comparison tools, shared topics, and a unified religious calendar.

Explore the interactive tools at wideholy.com — Compare Verses, Religious Calendar, Cross-Religion Topics

Table of Contents

• Install
• Quick Start
• What You'll Find on WideHoly
  • Five World Scriptures
  • Cross-Religion Comparison
  • Religious Calendar
• API Reference
• TypeScript Types
• Learn More About World Scriptures
• Also Available for Python
• WideHoly Family
• License

Install

npm install wideholy

yarn add wideholy

pnpm add wideholy

Zero runtime dependencies. Uses native fetch (Node 18+, Deno, Bun, browsers).

Works in any JavaScript runtime with global fetch:

| Runtime | Version | |---------|---------| | Node.js | 18+ | | Deno | 1.0+ | | Bun | 1.0+ | | Browsers | All modern (Chrome, Firefox, Safari, Edge) |

Quick Start

import { WideHoly } from "wideholy";

const api = new WideHoly();

// Get today's verse of the day from the Bible
const votd = await api.verseOfTheDay("bible");
console.log(votd.reference); // e.g. "Psalm 23:1"
console.log(votd.text);      // "The LORD is my shepherd; I shall not want."

// Compare Genesis 1:1 with Quran Al-Fatihah 1
const result = await api.compare("bible:genesis.1.1", "quran:al-fatihah.1");
console.log(result.verse_a.text); // "In the beginning God created..."
console.log(result.verse_b.text); // "In the name of Allah..."

// Search across all religions
const suggestions = await api.searchSuggest("love");
for (const s of suggestions.suggestions) {
  console.log(`  ${s.religion}: ${s.text} (${s.type})`);
}

What You'll Find on WideHoly

Five World Scriptures

WideHoly aggregates scripture data from 5 major world religions, each with its own dedicated site for deep exploration. The hub API provides unified cross-religion access to all 236,866 records.

| Religion | Scripture | Books | Records | Translations | Native Script | |----------|-----------|-------|---------|-------------|---------------| | Christianity | Holy Bible | 66 books (OT + NT) | 124,425 verses | KJV, NIV, ESV, NASB, NLT, ASV | English (Greek/Hebrew source) | | Islam | Holy Quran | 114 surahs | 31,102 ayahs | Sahih International, Pickthall, Yusuf Ali | Arabic | | Judaism | Tanakh + Talmud | 24 books + 63 tractates | 69,213 verses + 2,121 dapim | JPS, Koren, Artscroll | Hebrew / Aramaic | | Hinduism | Bhagavad Gita | 18 chapters | 6,800 verses | Swami Mukundananda, Eknath Easwaran | Sanskrit / Devanagari | | Buddhism | Tripitaka + Mahayana | 5 collections | 5,326 texts | Thanissaro Bhikkhu, Bhikkhu Bodhi | Pali / Sanskrit |

Each religion's data includes structured metadata: book/surah/chapter hierarchy, verse references, multiple translation editions, original language text, and cross-referenced topics for thematic exploration.

import { WideHoly } from "wideholy";

const api = new WideHoly();

// Get a random verse from any religion
const verse = await api.randomVerse();
console.log(`[${verse.religion}] ${verse.reference}: ${verse.text}`);

// Get today's Quran verse of the day
const quranVotd = await api.verseOfTheDay("quran");
console.log(quranVotd.text); // Today's selected ayah in English

The 5 religions use different verse reference formats. WideHoly normalizes all references to a religion:book.chapter.verse pattern for unified access:

| Religion | Reference Format | Example | |----------|-----------------|---------| | Bible | bible:book.chapter.verse | bible:genesis.1.1 | | Quran | quran:surah.ayah | quran:al-fatihah.1 | | Torah | torah:book.chapter.verse | torah:genesis.1.1 | | Gita | gita:chapter.verse | gita:2.47 | | Sutra | sutra:collection.text | sutra:dhammapada.1 |

Learn more: WideBible · WideQuran · WideTorah · WideGita · WideSutra

Cross-Religion Comparison

WideHoly provides 10 universal spiritual themes for cross-religion comparison, showing how different traditions address the same fundamental questions of human existence. Each theme includes curated verses and scholarly summaries from all 5 religions.

| Topic | Description | Religions | |-------|-------------|-----------| | Creation | Origin of the universe and humanity | Bible, Quran, Torah, Gita, Sutra | | Prayer | Communication with the divine | Bible, Quran, Torah, Gita, Sutra | | Love | Divine and human love | Bible, Quran, Torah, Gita, Sutra | | Afterlife | Death, judgment, and eternal life | Bible, Quran, Torah, Gita, Sutra | | Compassion | Mercy, kindness, and empathy | Bible, Quran, Torah, Gita, Sutra | | Fasting | Spiritual discipline and abstinence | Bible, Quran, Torah, Gita, Sutra | | Forgiveness | Repentance and divine pardon | Bible, Quran, Torah, Gita, Sutra | | Gratitude | Thankfulness and praise | Bible, Quran, Torah, Gita, Sutra | | Justice | Righteousness and moral law | Bible, Quran, Torah, Gita, Sutra | | Wisdom | Knowledge, understanding, and truth | Bible, Quran, Torah, Gita, Sutra |

import { WideHoly } from "wideholy";

const api = new WideHoly();

// Compare how religions discuss creation
const creation = await api.crossReligion("creation");
console.log(creation.title);   // "Creation"
console.log(creation.summary); // Scholarly overview
for (const entry of creation.religions) {
  console.log(`${entry.religion}: ${entry.summary}`);
  console.log(`  Key verse: [${entry.key_verse.reference}] ${entry.key_verse.text}`);
}

// Compare specific verses side by side — Genesis vs Al-Fatihah
const result = await api.compare("bible:genesis.1.1", "quran:al-fatihah.1");
console.log(`Bible:  ${result.verse_a.text}`);
console.log(`Quran:  ${result.verse_b.text}`);
console.log(`Cross-religion: ${!result.same_religion}`); // true

Learn more: Compare Verses · Cross-Religion Topics

Religious Calendar

WideHoly tracks 50 major religious events across all 5 traditions for 2026, including holidays, fasts, festivals, and observances. Events are sourced from each religion's liturgical calendar.

| Religion | Events | Examples | |----------|--------|---------| | Christianity | Easter, Christmas, Lent, Pentecost, Advent | Easter: April 5, 2026 | | Islam | Ramadan, Eid al-Fitr, Eid al-Adha, Mawlid | Ramadan begins: February 18, 2026 | | Judaism | Passover, Rosh Hashanah, Yom Kippur, Sukkot | Passover: April 2-9, 2026 | | Hinduism | Diwali, Holi, Navratri, Maha Shivaratri | Diwali: October 20, 2026 | | Buddhism | Vesak, Asalha Puja, Kathina, Magha Puja | Vesak: May 12, 2026 |

import { WideHoly } from "wideholy";

const api = new WideHoly();

// Get all religious events for March 2026
const events = await api.calendar({ month: 3 });
for (const e of events.events) {
  console.log(`  ${e.date}  ${e.religion.padEnd(10)}  ${e.name}`);
}

// Get only Jewish holidays for 2026
const torahEvents = await api.calendar({ religion: "torah" });
for (const e of torahEvents.events) {
  console.log(`  ${e.date}  ${e.name}`);
}

// Get Islamic events in December
const islamDec = await api.calendar({ religion: "quran", month: 12 });

Learn more: Religious Calendar

Features

• Zero dependencies -- uses native fetch, no axios/node-fetch/undici
• Fully typed -- all 8 endpoints return typed response interfaces
• Cross-religion -- unified API across Bible, Quran, Torah, Gita, and Sutra
• Tree-shakeable -- ESM-only output, import only what you need
• Configurable -- custom base URL for local development or self-hosted instances
• Lightweight -- under 4 KB bundled, no bloat

API Reference

| Method | Endpoint | Description | |--------|----------|-------------| | verseOfTheDay(religion?) | GET /api/v1/verse-of-the-day/ | Curated verse of the day, deterministic per date | | randomVerse(religion?) | GET /api/v1/random/ | Random verse, optionally filtered by religion | | compare(refA, refB) | GET /api/v1/compare/ | Side-by-side verse comparison | | searchSuggest(query, religion?) | GET /api/v1/search/suggest/ | Autocomplete across topics, people, glossary | | topicVerses(topic) | GET /api/v1/topics/{slug}/verses/ | Verses for a topic across religions | | crossReligion(topic) | GET /api/v1/cross-religion/{topic}/ | Thematic comparison with summaries | | calendar(options?) | GET /api/v1/calendar/ | Religious holidays and observances | | commentary(verseRef) | GET /api/v1/commentary/{verseRef}/ | Scholarly commentary (tafsir, Rashi, Gita) |

Example: Commentary

import { WideHoly } from "wideholy";

const api = new WideHoly();

// Get Quran tafsir for Al-Fatihah verse 1
const comm = await api.commentary("quran:al-fatihah.1");
console.log(comm.religion); // "quran"
for (const c of comm.commentaries) {
  console.log(`[${c.source}] ${c.author}: ${c.text.slice(0, 100)}...`);
}

// Get Torah Rashi commentary for Genesis 1:1
const rashi = await api.commentary("torah:genesis.1.1");
for (const c of rashi.commentaries) {
  console.log(`${c.author}: ${c.text}`);
}

Custom Base URL

// Use a local development server
const dev = new WideHoly("http://localhost:8000");

// Use a self-hosted instance
const selfHosted = new WideHoly("https://scripture.internal.company.com");

Full API documentation at wideholy.com/developers/. OpenAPI 3.1.0 spec: wideholy.com/api/schema/.

TypeScript Types

All API responses are fully typed. Import individual types as needed:

import type {
  VerseOfTheDay,
  RandomVerse,
  CompareResult,
  Suggestions,
  TopicVerses,
  CrossReligionResult,
  CalendarEvents,
  CalendarOptions,
  Commentary,
  Verse,
  CalendarEvent,
  CommentaryEntry,
} from "wideholy";

Key Types

| Type | Description | |------|-------------| | VerseOfTheDay | Daily verse with religion, reference, text, translation, date | | RandomVerse | Random verse with full metadata | | CompareResult | Two verses side-by-side with same_religion flag | | Suggestions | Search autocomplete with query and suggestion list | | TopicVerses | Per-religion verse collections for a topic | | CrossReligionResult | Thematic comparison with summaries per religion | | CalendarEvents | Religious events filtered by year, month, religion | | Commentary | Scholarly annotations (tafsir, Rashi, Gita commentaries) | | Verse | Base verse type: religion, reference, text, book, chapter, verse | | CalendarOptions | Query options: { religion?, year?, month? } |

Learn More About World Scriptures

• Compare: Verse Comparison Tool · Cross-Religion Topics
• Calendar: Religious Calendar 2026
• Browse: Bible Books · Quran Surahs · Torah Books · Gita Chapters · Buddhist Sutras
• API: REST API Docs · OpenAPI Spec
• Python: PyPI Package

Also Available for Python

| Platform | Install | Link | |----------|---------|------| | PyPI | pip install wideholy | PyPI | | MCP | uvx --from "wideholy[mcp]" python -m wideholy.mcp_server | Config |

WideHoly Family

| Site | Domain | Focus | |------|--------|-------| | WideBible | widebible.com | 66 books, 124K verses, 6 translations, commentaries | | WideQuran | widequran.com | 114 surahs, 31K ayahs, tafsir, hadith collections | | WideTorah | widetorah.com | 24 Tanakh books, 63 Talmud tractates, Rashi commentary | | WideGita | widegita.com | 18 chapters, 6,800 verses, Sanskrit, multiple commentaries | | WideSutra | widesutra.com | 5 collections, 5,326 texts, Pali/Sanskrit traditions | | WideHoly | wideholy.com | Cross-religion hub -- comparison, calendar, unified search |

License

MIT License. See LICENSE for details.