Skip to content

Latest commit

ย 

History

History
265 lines (195 loc) ยท 7.12 KB

README.md

File metadata and controls

265 lines (195 loc) ยท 7.12 KB

Bible API on GitHub ๐Ÿ‡ธ๐Ÿ‡ฆ ๐Ÿ‡จ๐Ÿ‡ณ ๐Ÿ‡ฉ๐Ÿ‡ช ๐Ÿ‡ฌ๐Ÿ‡ท ๐Ÿ‡บ๐Ÿ‡ธ ๐Ÿ‡ฌ๐Ÿ‡ง ๐Ÿ‡บ๐Ÿ‡ณ ๐Ÿ‡ช๐Ÿ‡ธ ๐Ÿ‡ซ๐Ÿ‡ฎ ๐Ÿ‡ซ๐Ÿ‡ท ๐Ÿ‡ฐ๐Ÿ‡ท ๐Ÿ‡ง๐Ÿ‡ท ๐Ÿ‡ต๐Ÿ‡น ๐Ÿ‡ท๐Ÿ‡ด ๐Ÿ‡ท๐Ÿ‡บ ๐Ÿ‡ป๐Ÿ‡ณ

Description

This repository provides a simple API to access verses from the Bible directly from GitHub. The verses are available in JSON format.

Postman

Check out the API versions here: API on Postman

Endpoints

Bible

To access the Bible translations, use the following endpoint:

https://raw.githubusercontent.com/maatheusgois/bible/main/versions/{language}/{bible-version}.json

Try:

curl https://raw.githubusercontent.com/maatheusgois/bible/main/versions/pt-br/arc.json

Books

To access specific books within a Bible version, use this endpoint:

https://raw.githubusercontent.com/maatheusgois/bible/main/versions/{language}/{bible-version}/{book-id}/{book-id}.json

Try:

curl https://raw.githubusercontent.com/MaatheusGois/bible/main/versions/pt-br/arc/gn/gn.json

Chapter and Verse

To access specific chapters and verses within a book, use the following endpoint:

https://raw.githubusercontent.com/maatheusgois/bible/main/versions/{language}/{bible-version}/{book-id}/{chapter}/{verse}.json

Try:

curl https://raw.githubusercontent.com/maatheusgois/bible/main/versions/pt-br/arc/2ch/2/1.json

Index

To get all available Bible versions and books, use this endpoint:

https://raw.githubusercontent.com/maatheusgois/bible/main/sumary/index.json

Try:

curl https://raw.githubusercontent.com/maatheusgois/bible/main/sumary/index.json

Summary

To get a summary of all available Bible versions and books, use this endpoint:

https://raw.githubusercontent.com/maatheusgois/bible/main/sumary/ids.json

Try:

curl https://raw.githubusercontent.com/maatheusgois/bible/main/sumary/ids.json

Languages and Versions

The summary endpoint provides an overview of available languages and versions. For detailed information, refer to the specific endpoints provided above.

Arabic ๐Ÿ‡ธ๐Ÿ‡ฆ

Language ID Version Name Version ID
ar The Arabic Bible svd

Chinese ๐Ÿ‡จ๐Ÿ‡ณ

Language ID Version Name Version ID
zh Chinese Union Version cuv
zh New Chinese Version ncv

German ๐Ÿ‡ฉ๐Ÿ‡ช

Language ID Version Name Version ID
de Schlachter schlachter

Greek ๐Ÿ‡ฌ๐Ÿ‡ท

Language ID Version Name Version ID
el Modern Greek greek

English ๐Ÿ‡บ๐Ÿ‡ธ๐Ÿ‡ฌ๐Ÿ‡ง

Language ID Version Name Version ID
en Basic English bbe
en King James Version kjv

Esperanto ๐Ÿ‡บ๐Ÿ‡ณ

Language ID Version Name Version ID
eo Esperanto esperanto

Spanish ๐Ÿ‡ช๐Ÿ‡ธ

Language ID Version Name Version ID
es Reina Valera rvr

Finnish ๐Ÿ‡ซ๐Ÿ‡ฎ

Language ID Version Name Version ID
fi Finnish Bible finnish
fi Pyhรค Raamattu pr

French ๐Ÿ‡ซ๐Ÿ‡ท

Language ID Version Name Version ID
fr Le Bible de I'ร‰pรฉe apee

Korean ๐Ÿ‡ฐ๐Ÿ‡ท

Language ID Version Name Version ID
ko Korean Version ko

Portuguese ๐Ÿ‡ง๐Ÿ‡ท๐Ÿ‡ต๐Ÿ‡น

Language ID Version Name Version ID
pt-br Almeida Revisada Imprensa Bรญblica aa
pt-br Almeida Corrigida e Revisada Fiel acf
pt-br Nova Versรฃo Internacional nvi
pt-br King James Fiel kja
pt-br Almeida Revista e Corrigida arc

Romanian ๐Ÿ‡ท๐Ÿ‡ด

Language ID Version Name Version ID
ro Versiunea Dumitru Cornilescu cornilescu

Russian ๐Ÿ‡ท๐Ÿ‡บ

Language ID Version Name Version ID
ru ะกะธะฝะพะดะฐะปัŒะฝั‹ะน ะฟะตั€ะตะฒะพะด synodal

Vietnamese ๐Ÿ‡ป๐Ÿ‡ณ

Language ID Version Name Version ID
vi Tiแบฟng Viแป‡t vietnamese

Book IDs

The table below lists the IDs and names of the books available in the API:

ID Name
gn Genesis
ex Exodus
lv Leviticus
nm Numbers
dt Deuteronomy
js Joshua
jud Judges
rt Ruth
1sm 1 Samuel
2sm 2 Samuel
1kgs 1 Kings
2kgs 2 Kings
1ch 1 Chronicles
2ch 2 Chronicles
ezr Ezra
ne Nehemiah
et Esther
job Job
ps Psalms
prv Proverbs
ec Ecclesiastes
so Song of Solomon
is Isaiah
jr Jeremiah
lm Lamentations
ez Ezekiel
dn Daniel
ho Hosea
jl Joel
am Amos
ob Obadiah
jn Jonah
mi Micah
na Nahum
hk Habakkuk
zp Zephaniah
hg Haggai
zc Zechariah
ml Malachi
mt Matthew
mk Mark
lk Luke
jo John
act Acts
rm Romans
1co 1 Corinthians
2co 2 Corinthians
gl Galatians
eph Ephesians
ph Philippians
cl Colossians
1ts 1 Thessalonians
2ts 2 Thessalonians
1tm 1 Timothy
2tm 2 Timothy
tt Titus
phm Philemon
hb Hebrews
jm James
1pe 1 Peter
2pe 2 Peter
1jo 1 John
2jo 2 John
3jo 3 John
jd Jude
re Revelation

Formatting

npx prettier --write .

Contributing

This repository is open to contributions. Feel free to propose improvements or add new features. To contribute, please submit a pull request with your changes.

If you encounter any issues or have suggestions, please open an issue to discuss.

License

This project is distributed under the MIT license.