π 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.
- 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
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:
π API Endpoints
Single Verse Endpoint
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) |
GET /NIV/single?book=Genesis&chapter=1&verse=1
{
"book": "Genesis",
"chapter": 1,
"verse": 1,
"content": "In the beginning God created the heavens and the earth."
}
Multiple Verses Endpoint
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
GET /NIV/multiple?verses=Genesis 1:1-3,Matthew 1:1-25
Pericope (Headings) Endpoint
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 |
GET /CNVS/headings?book=Genesis&chapter=1
Keyword Search Endpoint
Search for verses containing specific keywords within a single translation.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| translation | path | Required | Bible translation code |
| keyword | query | Required | Keyword or phrase to search for |
| limit | query | Optional | Max results (default: 50) |
| book | query | Optional | Filter by book name |
| testament | query | Optional | Filter: "old"/"ot" or "new"/"nt" |
# Basic search GET /NIV/search?keyword=love&limit=10 # Search in specific book GET /NIV/search?keyword=faith&book=Hebrews&limit=5 # Search in Old Testament only GET /NIV/search?keyword=covenant&testament=old&limit=20 # Search in New Testament only GET /NIV/search?keyword=grace&testament=new&limit=15
Multi-Translation Search Endpoint
Search for verses containing specific keywords across multiple translations simultaneously.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| keyword | query | Required | Keyword or phrase to search for |
| translations | query | Optional | Comma-separated translations (default: NIV) |
| limit | query | Optional | Max results per translation (default: 50) |
| book | query | Optional | Filter by book name |
| testament | query | Optional | Filter: "old"/"ot" or "new"/"nt" |
# Basic multi-translation search GET /search?keyword=faith&translations=NIV,ESV,KJV&limit=5 # Search specific book across translations GET /search?keyword=love&translations=NIV,ESV&book=1Corinthians&limit=10 # Search Old Testament across multiple translations GET /search?keyword=righteous&translations=NIV,KJV,NASB&testament=old&limit=15
π‘ Code Examples
JavaScript / Fetch
// 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
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
# 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": "Verse not found: Genesis 1:999" }
400 - Missing Parameters
{ "error": "Keyword parameter is required" }
500 - Server Error
{ "error": "Error fetching the verse." }
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
# Clone the repository git clonecd BlessingsAPI # Install dependencies npm install # Start the server npm start # API will be available at http://localhost:3000
The API is CORS-enabled, so you can make requests directly from browser-based applications without any additional configuration.