biblegateway-scrape

v0.1.2

Published

a month ago

A webscrape version of Biblegateway.com

0High
0Medium
0Low

ryannkim327

Bible tagalog biblegateway biblegateway-scrape bible baybayin transliterated bible (test)audio verses audio bible

Bible Gateway Scrape

A simple yet powerful web scraper for BibleGateway.com, providing access to various Bible versions including Tagalog and even Baybayin transliteration.

🚀 Features

Text Verses: Fetch any verse from Bible Gateway.
Daily Verse: Get the "Verse of the Day".
Audio Bible: Retrieve MP3 links for various audio Bible versions.
Baybayin Support: Transliterated Tagalog bibles into Baybayin script.
TypeScript Support: Fully typed for a better development experience.

📦 Installation

npm install biblegateway-scrape@latest

📖 How to Use

1. Fetching a Verse

const biblegateway = require("biblegateway-scrape");

async function getVerse() {
  const result = await biblegateway.verse("John 3:16", biblegateway.version.TAG_ANG_DATING_BIBLIYA_1905);
  console.log(result);
}

getVerse();

Output:

{
  "book": "Juan 3:16",
  "verses": [
    "16 Sapagka't gayon na lamang ang pagsinta ng Dios sa sanglibutan, na ibinigay niya ang kaniyang bugtong na Anak, upang ang sinomang sa kaniya'y sumampalataya ay huwag mapahamak, kundi magkaroon ng buhay na walang hanggan. "
  ]
}

2. Daily Verse

const biblegateway = require("biblegateway-scrape");

async function getDaily() {
  // Get today's verse
  const today = await biblegateway.daily_verse(biblegateway.version.TAG_ANG_DATING_BIBLIYA_1905);
  console.log(today);

  // Get verse for a specific date [Year, Month, Day]
  const specificDate = await biblegateway.daily_verse(biblegateway.version.TAG_ANG_DATING_BIBLIYA_1905, [2024, 12, 25]);
  console.log(specificDate);
}

getDaily();

3. Audio Bible

const biblegateway = require("biblegateway-scrape");

async function getAudio() {
  const audio = await biblegateway.audio("John 1", biblegateway.audio_version.KJV_PAUL_MIMS);
  console.log(audio);
}

getAudio();

Output:

{
  "result_code": 200,
  "mp3": "https://stream.biblegateway.com/bibles/32/kjv-mims/John.1.mp3",
  "copyright": "© 2007 All Rights Reserved The Spoken Word of God."
}

🛠️ Parameters

Bible Versions (`biblegateway.version`)

Audio Versions (`biblegateway.audio_version`)

📜 Changelog

v0.1.2 (2026-04-03)

Updated README with a comprehensive, categorized list of all 19 supported audio versions.
Added detailed parameter tables for easier reference.
Bumped version for documentation parity.

v0.1.0 (2025-10-26)

Fixed bugs in version 0.0.9.
Fixed daily_verse fetching issues.
Improved overall stability.

v0.0.9 (2025-10-26)

Cleaned up Baybayin transliteration logic.
Initial TypeScript implementation and structure.

v0.0.1 - v0.0.8

Initial web scraping implementation for BibleGateway.
Basic support for Tagalog and English versions.
Added audio support (MP3).

📄 License

This project is licensed under the MIT License - see the LICENSE.md file for details.

🤝 Credits & Acknowledgements

Bible Gateway: For providing the amazing resource this scraper uses.
Contributors: RyannKim327, Salvador, John Jeremy Antiguo, and many others.
NodeJS Community: For the tools and libraries that made this possible.

Note: This is a web-scraping project. Please use it responsibly and respect Bible Gateway's terms of service. Always provide credit and copyright information when using their resources.