Giter VIP home page Giter VIP logo

bible-api's Introduction

Bible API

Welcome to Bible API, your go-to resource for easy access to Bible verses and chapters across multiple versions and languages. With a simple request, obtain the text of a specific verse or an entire chapter, perfect for developers, researchers, and Bible enthusiasts who want to incorporate the Holy Scripture into their applications, websites, or projects.

Overview

Quick Start

To begin using Bible API, no API keys or authentication are required. Simply send a request to the desired endpoint with the necessary parameters, and receive the data in JSON format.

API Endpoints

Get a Verse

To obtain a specific verse, send a request to the following endpoint:

https://cdn.jsdelivr.net/gh/wldeh/bible-api/bibles/${version}/books/${book}/chapters/${chapter}/verses/${verse}.json

Replace ${version}, ${book}, ${chapter}, and ${verse} with the appropriate values.

Parameters:

  • version: The Bible version (e.g., en-asv, en-kjv)
  • book: The book of the Bible (e.g., genesis, exodus)
  • chapter: The chapter number
  • verse: The verse number

Get a Chapter

To access an entire chapter, send a request to the following endpoint:

https://cdn.jsdelivr.net/gh/wldeh/bible-api/bibles/${version}/books/${book}/chapters/${chapter}.json

Replace ${version}, ${book}, and ${chapter} with the appropriate values.

Parameters:

  • version: The Bible version (e.g., en-asv, en-kjv)
  • book: The book of the Bible (e.g., genesis, exodus)
  • chapter: The chapter number

Key Features

  • Blazing Fast and Reliable: Experience lightning-fast response times and exceptional reliability, ensuring a seamless and efficient integration with your applications and projects.
  • Completely Free: The Bible API is entirely free to use, making it accessible to everyone, regardless of budget constraints or project size.
  • Access to Multiple Bible Versions: The Bible API currently supports numerous Bible versions and is continuously expanding to include more translations, ensuring you have access to a diverse range of Scripture texts.
  • Support for 300+ Languages: Our goal is to cover over 300 languages and translations, making the Bible API one of the most comprehensive and inclusive resources for accessing the Holy Scripture in various languages.
  • Regularly Updated and Maintained: Our dedicated team regularly updates and maintains the Bible API, ensuring its accuracy, reliability, and continued improvement.
  • Public Domain Versions: Access public domain Bible versions without any copyright restrictions, allowing for a wide range of uses and applications.
  • Simple and Easy-to-use API: The Bible API's straightforward design and extensive documentation make it easy for developers of all skill levels to integrate it into their projects.
  • Extensive Documentation: Comprehensive documentation provides clear instructions, examples, and guidelines to help you make the most of the Bible API and its features.

Supported Versions

Use the following endpoint to view a list of all available Bible versions:

https://cdn.jsdelivr.net/gh/wldeh/bible-api/bibles/bibles.json

The response will display an array of Bible versions with their associated metadata, including the version ID, name, description, language, and more.

Examples

In this section, you'll find examples demonstrating the use of Bible API, along with code snippets showcasing its implementation in various programming languages.

API Request Examples:

  • Retrieve Genesis 1:1 in the American Standard Version (ASV):

    https://cdn.jsdelivr.net/gh/wldeh/bible-api/bibles/en-asv/books/genesis/chapters/1/verses/1.json
    
  • Fetch John 3:16 in the King James Version (KJV):

    https://cdn.jsdelivr.net/gh/wldeh/bible-api/bibles/en-kjv/books/john/chapters/3/verses/16.json
    
  • Access the complete chapter of Psalm 23 in the American Standard Version (ASV):

    https://cdn.jsdelivr.net/gh/wldeh/bible-api/bibles/en-asv/books/psalms/chapters/23.json
    

Code Snippets:

JavaScript

fetch(
  "https://cdn.jsdelivr.net/gh/wldeh/bible-api/bibles/en-asv/books/genesis/chapters/1/verses/1.json"
)
  .then((response) => response.json())
  .then((data) => console.log(data.text));

Python

import requests

response = requests.get("https://cdn.jsdelivr.net/gh/wldeh/bible-api/bibles/en-asv/books/genesis/chapters/1/verses/1.json")
data = response.json()
print(data["text"])

PHP

$response = file_get_contents("https://cdn.jsdelivr.net/gh/wldeh/bible-api/bibles/en-asv/books/genesis/chapters/1/verses/1.json");
$data = json_decode($response, true);
echo $data["text"];

FAQs

Q: Is an API key or authentication needed to use Bible API?

A: No, Bible API does not require API keys or authentication. Simply send a request to the desired endpoint with the necessary parameters to receive the data in JSON format.

Q: How often are new Bible versions added to the API?

A: We continuously strive to add new Bible versions to the API. If you have a specific version you'd like to see included, please open an issue or contact a maintainer.

Q: Can I use Bible API for commercial purposes?

A: Yes, Bible API can be used for commercial purposes. However, be aware of copyright restrictions on some Bible versions. Consult the metadata of each version for information on their respective licenses.

Upcoming Features

We are continuously working on improving and expanding the Bible API to provide you with the best possible experience. Here's a sneak peek at some of the exciting features we have planned for future releases:

Feature Description
Additional Bible Translations Add support for 300+ languages
Natural Language Processing (NLP) Search Perform advanced searches using natural language queries
Audio Bible Integration Access Bible verses with high-quality audio recordings
Study Notes and Commentary Access study notes and commentary from renowned Bible scholars
Bible Reading Plans Access a variety of Bible reading plans to help users read through the Bible consistently
Bible Quiz and Trivia Test your Bible knowledge with fun quizzes and trivia questions
Verses of the Day Access a daily curated verse through a dedicated endpoint
Mobile SDKs for iOS and Android Easily integrate the Bible API into mobile apps with our official SDKs
AI-Generated Bible Summaries Receive concise, AI-generated summaries of Bible chapters and stories
Sentiment Analysis Analyze the sentiment of Bible verses and passages using AI algorithms
AI-Powered Verse Clustering Discover related verses and passages through AI-powered clustering and grouping
Personalized AI-Generated Bible Studies Experience tailored Bible studies generated by AI based on preferences and interests
AI-Driven Scripture Insights Unlock deeper insights into Bible verses using cutting-edge AI analysis techniques
AI-Generated Bible-Verse-to-Image Receive beautiful, AI-generated images inspired by Bible verses
Conversational AI for Bible Study Interact with an AI-powered virtual assistant to guide you through your Bible study sessions

Contribute

We encourage contributions to enhance and expand Bible API. For suggestions, or feature requests, please open an issue on our GitHub repository. If you'd like to contribute, feel free to submit a pull request. A contributing guide is under development.

Licensing

Bible API is available under the MIT License. The text of the Bible versions provided by the API may have additional copyright restrictions. Consult the metadata of each version for information on their respective licenses.


Crafted with 💙 by the Bible API Team. Enjoy!

bible-api's People

Contributors

wldeh avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

bible-api's Issues

Question About Language

Hello dear Bible Api team !

I was asking if French is supported ?

If I wanted to put Jean 14:6 instead of John 14:6 and Apocalypse 22:10 instead of Revelation 22:10, would it work perfectly ?

Thanks in advance !

God bless you ;)

All verses are duplicated in json file of a chapter

Describe the bug
All verses are duplicated in json file of a chapter. Ex: https://cdn.jsdelivr.net/gh/wldeh/bible-api/bibles/en-kjv/books/songofsolomon/chapters/1.json , there are only 17 verses for this chapter, but this shows 34.

To Reproduce
Go to any json file of any chapter. All verses appear twice.

Expected behavior
A verse should appear only once in a chapter's json.

Screenshots
If applicable, add screenshots to help explain your problem.

Some of the verses have incorrect text

Describe the bug
Some of the verses have incorrect text. For ex: https://cdn.jsdelivr.net/gh/wldeh/bible-api/bibles/en-kjv/books/songofsolomon/chapters/1.json

See verses: 2, 4, 7, 8, 14, 15, 17.

They have some incorrect text after the correct verse Ends.

songofsolomon 1:2: "Let him kiss me with the kisses of his mouth: for thy love is better than wine.1.2 thy…: Heb. thy loves"
songofsolomon 1:4: "Draw me, we will run after thee: the king hath brought me into his chambers: we will be glad and rejoice in thee, we will remember thy love more than wine: the upright love thee.1.4 the upright…: or, they love thee uprightly"
songofsolomon 1:7: "Tell me, O thou whom my soul loveth, where thou feedest, where thou makest thy flock to rest at noon: for why should I be as one that turneth aside by the flocks of thy companions?1.7 as one…: or, as one that is veiled"

After the correct verse ends, it has 'chapter.verse' and then some random text.

To Reproduce
Steps to reproduce the behavior:
Go to https://cdn.jsdelivr.net/gh/wldeh/bible-api/bibles/en-kjv/books/songofsolomon/chapters/1.json and see verses 2, 4, 7, 8, 14, 15, 17

Expected behavior
The verse should end correctly.

Return the names of the book withing a version

Is your feature request related to a problem? Please describe.
Yes, many people would like to explore more version but not knowing the names a the Bible books would be a problem, could create a direct api that will return the names of the books that are in the given version

Describe the solution you'd like
api call returning a json with names ofthe book in the given version

Describe alternatives you've considered
this could be useful
https://github.com/wldeh/bible-api/tree/main/bibles/cmn-Hans-CN-feb/books.json

Additional context
just a json return

Incomplete return of certain verses for certain versions

Describe the bug
When using the English ASV and WEB translations, certain verses return only the first part of a verse instead of the entire verse.

To Reproduce

https://cdn.jsdelivr.net/gh/wldeh/bible-api/bibles/en-asv/books/habakkuk/chapters/3/verses/2.json

This is the ASV version. You will see that it only returns up to the colon. The verse is incomplete. This appears so be an issue for multiple verses, you can check the rest of the verses in Habakkuk chapter 3. The issue also appears in the WEB version. The KJV version appears to be okay.

Expected behavior
The full verse should be returned for all verses in the Bible translations

Screenshots
N/A

Desktop (please complete the following information):

  • OS: iOS & Mac
  • Browser: Safari
  • Version: N/A

Smartphone (please complete the following information):

  • Device: iOS Simulator & Desktop Browser
  • OS: Mac OSX
  • Browser: Safari

Additional context
Add any other context about the problem here.

translations

Great project @wldeh !

It will be great to add English translations for very popular versions like:

  • New International Version (NIV)
  • New Living Translation (NLT)
  • English Standard Version (ESV)
  • The Message (MSG)
  • Living Bible Translation
  • Amplified Bible (AMP)
  • Christian Standard Bible (CSB)
  • New Revised Standard Version (NRSV)

and please let me know if there's any way I can support this. thanks and God bless.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.