Misikirayu/amharic-bible-api

# Open Amharic Bible API **URL:** openamharicbible.vercel.app A RESTful API providing access to the full Amharic Holy Bible in structured JSON format. Each book is served as JSON with chapters and verses. Perfect for developers, researchers, or enthusiasts building apps, websites, or educational projects. --- Perfect for: * Bible apps 📱 * Church websites ⛪ * Study tools 📚 * Language and text projects 🇪🇹 --- ## Live Demo Visit: openamharicbible.vercel.app Landing page includes instructions, usage examples, and quick links to all endpoints. --- ## 🌟 Features * ✅ Full Amharic Bible support * ✅ One JSON file per book * ✅ Clean REST API structure * ✅ Easy to add new books (other languages, e.g., Afaan Oromo) * ✅ No database required * ✅ Unicode-safe (Amharic URLs work) * ✅ Full-text search with optional limit * ✅ Search by testament (old/new) * ✅ Book abbreviation routing supported --- ## 📞 Project Structure ``` amharic-bible-api/ │ ├── data/ │ └── books/ │ ├── ኦሪት ዘፍጥረት.json │ ├── ኦሪት ዘጸአት.json │ └── ... │ ├── controllers/ │ └── bible.controller.js │ ├── routes/ │ └── bible.routes.js │ ├── utils/ │ ├── bookLoader.js │ └── getTestament.js │ ├── config/ │ └── testamentMap.js │ ├── app.js └── package.json ``` --- ## 📚 Data Format (Per Book) Example: `ኦሪት ዘፍጥረት.json` ```json { "title": "ኦሪት ዘፍጥረት", "abbv": "ዘፍ", "chapters": [ { "chapter": "1", "title": "", "verses": [ "በመጀመሪያ እግዚአብሔር ሰማይንና ምድርን ፈጠረ።" ] } ] } ``` --- ## 🚀 Getting Started ### 1️⃣ Clone the project ```bash git clone github.com cd amharic-bible-api ``` ### 2️⃣ Install dependencies ```bash npm install ``` ### 3️⃣ Start the server ```bash node app.js ``` Server runs at: ``` localhost ``` --- ## API Usage ### List all books ``` GET /api/am/books ``` ``` curl openamharicbible.vercel.app ``` --- ### Get all chapters of a book ``` GET /api/am/books/:book/chapters …