Blessings API documentation

Scripture data for developers, with eleven translations, flexible verse lookup, structural headings, and keyword search.

Base URL
https://api.blessings365.top

Overview

Blessings API provides programmatic access to Scripture through predictable REST endpoints and JSON responses. CORS is enabled for direct use in web applications.

Core Capabilities
  • Retrieve precise single verses or expansive verse ranges.
  • Search across a single translation or multiple translations concurrently.
  • Filter results programmatically by specific book or testament.
  • Access structural headings (pericopes) for contextual reading.

Translations

Eleven distinct translations are currently indexed, spanning English, Chinese, and Indonesian lexicons.

  • 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

Single Verse

Retrieve a discrete verse by specifying the book, chapter, and verse integers.

GET /{translation}/single
Parameters for the single verse endpoint
Parameter Type Requirement Description
translation path Required Translation code (e.g., NIV).
book query Required The title of the book (e.g., Genesis).
chapter query Required Integer representing the chapter.
verse query Required Integer representing the verse.
Response 
{
  "book": "Genesis",
  "chapter": 1,
  "verse": 1,
  "content": "In the beginning God created the heavens and the earth."
}

Multiple Verses

Retrieve sequences or non-contiguous selections using a comma-separated list of textual references.

GET /{translation}/multiple
Parameters for the multiple verses endpoint
Parameter Type Requirement Description
verses query Required Comma-separated query string. E.g., Genesis 1:1-3,Matthew 1:1-25.

Supported Notation Formats:
Single: Genesis 1:1
Range: Genesis 1:1-3
Cross-Chapter: Genesis 1:1-2:3
Full Chapter: Genesis 1

Pericope (Headings)

Extract the structural headings embedded within specific translations to contextualize readings.

GET /{translation}/headings
Parameters for the headings endpoint
Parameter Type Requirement Description
book query Required The target book name.
chapter query Optional Target chapter. If omitted, returns headings for the entire book.

Implementation Examples

JavaScript

JS 
const fetchVerse = async () => {
  const res = await fetch('https://api.blessings365.top/ESV/single?book=Psalms&chapter=23&verse=1');
  const data = await res.json();
  console.log(`${data.book} ${data.chapter}:${data.verse}: ${data.content}`);
};

fetchVerse();

Python

Python 
import requests

response = requests.get(
    'https://api.blessings365.top/search',
    params={'keyword': 'grace', 'translations': 'NIV,ESV', 'limit': 5}
)
print(response.json())

Error Handling

The API returns standard HTTP status codes indicating success or failure of a request.

HTTP error responses and recommended resolutions
Code Meaning Resolution
400 Bad Request Required parameters such as keyword, book, or verses are missing.
404 Not Found The requested verse does not exist, or headings are unavailable for that translation.
500 Server Error Internal exception, often due to an unhandled parse error.