Free Use Bible SDK

Add Bible text to your website or web app without having to worry about licensing and legal issues surrounding Bible text.

This is a type-safe Bible SDK to use in your web apps and websites.

Installation

npm install free-use-bible-sdk

Usage

import { FreeUseBibleSDK } from "free-use-bible-sdk";

const client = new FreeUseBibleSDK({
  baseUrl: "https://bible.helloao.org/",
});

const chapterResponse = await client.general.getChapterFromTranslation(
  "BSB",
  "Romans",
  8,
);
console.log(chapterResponse);

OpenAPI spec (created based on these docs) + apigen-ts = FreeUseBibleSDK

Bible text comes from the Free Use Bible API, generously provided by AO Lab.

API Overview

The SDK provides access to Bible translations and commentaries through the following methods:

Translations

• getAvailableTranslations() - Get list of available Bible translations
• getBooksForTranslation(translation: string) - Get books for a specific translation
• getChapterFromTranslation(translation: string, book: string, chapter: number) - Get chapter content

Commentaries

• getAvailableCommentaries() - Get list of available commentaries
• getBooksForCommentary(commentary: string) - Get books for a commentary
• getChapterFromCommentary(commentary: string, book: string, chapter: number) - Get commentary chapter
• getProfilesForCommentary(commentary: string) - Get profiles for a commentary
• getProfileFromCommentary(commentary: string, profile: string) - Get specific profile content

All methods return typed responses with full TypeScript support.

Let me know how I can make it better.

— Cam