πŸ™ Blessings API

A comprehensive Bible verse API supporting multiple translations with powerful search capabilities

πŸ“– Overview

The Blessings API provides access to Bible verses from multiple translations. You can fetch single verses, multiple verse ranges, search by keywords, and retrieve pericope headings with flexible formatting options.

πŸ’‘
Key Features
  • 11 Bible translations (English, Chinese, Indonesian)
  • Single verse and multiple verse retrieval
  • Keyword search with filtering options
  • Multi-translation search capability
  • Pericope (section headings) support
  • JSON response format with CORS enabled

🌐 Base URL

http://api.blessings365.top

All API requests should be made to this base URL followed by the specific endpoint paths.

πŸ“š Available Translations

The following Bible translations are currently supported:

NIV
New International Version
ESV
English Standard Version
KJV
King James Version
NASB
New American Standard Bible
NLT
New Living Translation
TLB
The Living Bible
CNVS
Chinese New Version (Simplified)
CUNPSS-上帝
Chinese Union (God)
CUNPSS-η₯ž
Chinese Union (Shen)
CUV
Chinese Union (Traditional)
TB
Terjemahan Baru (Indonesian)

πŸ”— API Endpoints

Single Verse Endpoint

GET /{translation}/single

Retrieves a single verse from the specified translation.

Parameters

Parameter Type Required Description
translation path Required Bible translation code (e.g., NIV, ESV, KJV)
book query Required Bible book name (e.g., Genesis, Matthew, Psalms)
chapter query Required Chapter number (integer)
verse query Required Verse number (integer)
Request
GET /NIV/single?book=Genesis&chapter=1&verse=1
Response
{
  "book": "Genesis",
  "chapter": 1,
  "verse": 1,
  "content": "In the beginning God created the heavens and the earth."
}

Multiple Verses Endpoint

GET /{translation}/multiple

Retrieves multiple verses or verse ranges from the specified translation.

Parameters

Parameter Type Required Description
translation path Required Bible translation code
verses query Required Comma-separated list of verse references

Verse Reference Formats

  • Single verse: Genesis 1:1
  • Verse range: Genesis 1:1-3
  • Chapter range: Genesis 1:1-2:3
  • Entire chapter: Genesis 1
  • Multiple chapters: Genesis 1-3
Request
GET /NIV/multiple?verses=Genesis 1:1-3,Matthew 1:1-25

Pericope (Headings) Endpoint

GET /{translation}/headings

Retrieves pericope headings (section titles) for a specific book or chapter.

Parameters

Parameter Type Required Description
translation path Required Bible translation code (e.g., CNVS)
book query Required Bible book name
chapter query Optional Chapter number to filter headings
Request
GET /CNVS/headings?book=Genesis&chapter=1

πŸ’‘ Code Examples

JavaScript / Fetch

JavaScript
// Fetch a single verse
const response = await fetch(
  'http://api.blessings365.top/NIV/single?book=John&chapter=3&verse=16'
);
const verse = await response.json();
console.log(verse);

// Fetch multiple verses
const multiResponse = await fetch(
  'http://api.blessings365.top/ESV/multiple?verses=Psalms 23:1-6,John 14:6'
);
const verses = await multiResponse.json();
console.log(verses);

// Search for keywords
const searchResponse = await fetch(
  'http://api.blessings365.top/NIV/search?keyword=love&limit=10'
);
const results = await searchResponse.json();
console.log(results);

Python

Python
import requests

# Single verse
response = requests.get(
    'http://api.blessings365.top/NLT/single',
    params={'book': 'Philippians', 'chapter': 4, 'verse': 13}
)
verse = response.json()
print(f"{verse['book']} {verse['chapter']}:{verse['verse']} - {verse['content']}")

# Multiple verses
response = requests.get(
    'http://api.blessings365.top/ESV/multiple',
    params={'verses': 'Isaiah 40:31,Jeremiah 29:11'}
)
for verse in response.json():
    print(f"{verse['book']} {verse['chapter']}:{verse['verse']}")

# Search
response = requests.get(
    'http://api.blessings365.top/NIV/search',
    params={'keyword': 'love', 'limit': 10}
)
results = response.json()
print(f"Found {results['total_results']} verses")

cURL

Bash
# Single verse
curl "http://api.blessings365.top/KJV/single?book=Romans&chapter=8&verse=28"

# Multiple verses
curl "http://api.blessings365.top/NASB/multiple?verses=1%20Corinthians%2013:4-8"

# Search
curl "http://api.blessings365.top/NIV/search?keyword=love&limit=10"

⚠️ Error Handling

404 - Verse Not Found

❌
Error Response
{ "error": "Verse not found: Genesis 1:999" }

400 - Missing Parameters

⚠️
Error Response
{ "error": "Keyword parameter is required" }

500 - Server Error

πŸ’₯
Error Response
{ "error": "Error fetching the verse." }
ℹ️
Note

Invalid translation codes or verse formats will result in a 500 error. Always use supported translations and valid reference formats.

πŸš€ Getting Started

Quick Test URLs

Click the links below to test the API directly in your browser:

Local Development

Terminal
# Clone the repository
git clone 
cd BlessingsAPI

# Install dependencies
npm install

# Start the server
npm start

# API will be available at http://localhost:3000
βœ…
Ready to Go!

The API is CORS-enabled, so you can make requests directly from browser-based applications without any additional configuration.