widebible

Async Rust SDK for the WideBible API. Access all 66 books of the Bible, verses across multiple translations (KJV, ASV, BBE, YLT), biblical people, places, topics, cross-references, glossary terms, timeline events, and reading plans.

Built on widebible.com -- a comprehensive Bible encyclopedia with full-text search, cross-references between Old and New Testament passages, and study tools for scholars and developers.

Install

[dependencies]
widebible = "0.1"
tokio = { version = "1", features = ["full"] }

Or via the command line:

cargo add widebible tokio --features tokio/full

Quick Start

use widebible::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    // List all 66 books of the Bible
    let books = client.list_books().await?;
    println!("Total books: {:?}", books.count);

    // Get a specific verse -- John 3:16 in KJV
    let verse = client.get_verse("john", 3, 16, "kjv").await?;
    for v in &verse.results {
        println!("{}: {}", v.reference.as_deref().unwrap_or(""), v.text.as_deref().unwrap_or(""));
    }

    // Search across all Bible verses
    let results = client.search("love").await?;
    println!("Found {:?} results for 'love'", results.count);

    Ok(())
}

What You Can Do

Books and Translations

The Bible contains 66 books across two testaments. WideBible organizes them into book groups -- Pentateuch (Genesis through Deuteronomy), Historical Books, Wisdom Literature, Major Prophets, Minor Prophets, Gospels, Pauline Epistles, General Epistles, and Revelation.

Four English translations are available: King James Version (KJV, 1611), American Standard Version (ASV, 1901), Bible in Basic English (BBE, 1949), and Young's Literal Translation (YLT, 1862).

// List book groups (Pentateuch, Gospels, etc.)
let groups = client.list_book_groups().await?;

// Get details for a specific book
let genesis = client.get_book("genesis").await?;

// List available translations
let translations = client.list_translations().await?;

Verses and Search

Every verse is indexed for full-text search. Retrieve individual verses by book, chapter, and verse number, or search across the entire Bible by keyword.

// Get Genesis 1:1 in KJV
let verse = client.get_verse("genesis", 1, 1, "kjv").await?;

// Search for verses about faith
let results = client.search("faith").await?;

People and Places

WideBible catalogues biblical people -- prophets, kings, apostles, judges -- and places with geocoded coordinates. Explore figures like Abraham, Moses, David, and Paul, or locations like Jerusalem, Bethlehem, and Mount Sinai.

// List all biblical people
let people = client.list_people().await?;

// Get details for a specific person
let moses = client.get_person("moses").await?;

// List biblical places
let places = client.list_places().await?;

Topics and Cross-References

Thematic verse collections group passages by topic -- love, faith, prayer, salvation, creation, wisdom, and more. Cross-references connect related passages across Old and New Testaments.

// List thematic topics
let topics = client.list_topics().await?;

// Get verses for a specific topic
let love = client.get_topic("love").await?;

// List cross-references
let xrefs = client.list_cross_references().await?;

Glossary and Timeline

The glossary defines Hebrew and Greek biblical terms with transliterations and definitions. The timeline places events in historical context across eras from the Patriarchs through the Early Church.

// List glossary terms
let glossary = client.list_glossary().await?;

// Get a specific term
let term = client.get_glossary_term("agape").await?;

// List timeline eras
let eras = client.list_eras().await?;

Reading Plans

Structured Bible reading plans guide readers through Scripture over defined periods -- chronological reading, thematic studies, and book-by-book plans.

let plans = client.list_reading_plans().await?;
let plan = client.get_reading_plan("chronological").await?;

API Methods

All methods are async and return Result<T, WideBibleError>.

Custom Base URL

let client = Client::with_base_url("http://localhost:8000/api/v1/bible");

Error Handling

use widebible::{Client, WideBibleError};

let client = Client::new();
match client.get_book("nonexistent").await {
    Ok(book) => println!("Found: {:?}", book.name),
    Err(WideBibleError::Api { status, body }) => {
        eprintln!("API error {}: {}", status, body);
    }
    Err(WideBibleError::Http(e)) => {
        eprintln!("Network error: {}", e);
    }
}

WideHoly Scripture Platform

Part of the WideHoly multi-religion scripture platform.

Also Available

Learn More About the Bible

• Scripture: Books · Translations
• Reference: People · Places · Topics
• Study: Glossary · Timeline
• Tools: Search · Developer Docs
• API: Developer Docs · OpenAPI Spec

License

MIT