Public
Free Use Bible API TS SDK
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.

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