KJV API

KJV accessible via web calls

Usage

URL Root: https://api.1611.social/ (you are here)

/random - a random JSON-encoded verse. Different every time.
/votd - json-encoded verse changes from day-to-day.
/p/someverse - will attempt to parse and return the Bible requested in plaintext (pretty, with escape characters)
/someverse - will attempt to parse and return the Bible requested in plaintext, with no escape characters. Newlines are encoded as "/n" - for you to handle.
/s/keyword - will return any verses containing keyword in a JSON list
/sp/keyword - will return any verses containing keyword in a newline (html break) delimited list
/sl/keyword - will return all searched references and the scripture in JSON
/spl/keyword - will return all searched references and the scripture in text delmied by a newline

Verse searching

'/someverse' accepts verse references in a variety of forms, including single verses and verse ranges. For example:

Jn3:16, john3:16,17 ps1:1-6

Most recognizable abbreviations are allowed, and spelling errors are ignored if the book can be made out in the first few characters. No distinction is made between upper and lower case. Multiple references may be provided on an input line, delimited by spaces or commas.

Keyword searching

'/s*/keyword' accepts a search word, and will return any verses matching the query

Integration

If you want to put the verse of the day into your website, you can use the following example php:

echo curl_exec(curl_init('https://api.1611.social/votd?view=plain'));


FUTURE ENDPOINT SPECIFICATION
======================

/random - outputs a random verse
/votd - returns verse of the day
/search - returns a keyword search result set
/show - returns a verse or set of verses by name/location

URL PARAMETERS
==============
?view=
- json - json-encoded response
- plain - plaintext response
- rich - pretty response with css
default: json

?kw=
- comma-delimited keyword search for /search
search default: faith
show default: john3:16

?op=
- Multi-keyword search operator
- and - both keywords must be in verse
- any - any keyword must be in a verse
search default: any

?fz=
- on - fuzzy search on
default: off

EXAMPLES
========
api.tld/random?view=json
api.tld/votd?view=human
api.tld/show?kw=john3:16,1john5:7&view=plain
api.tld/search?kw=faith
api.tld/search?kw=nimrod&view=rich

Bugs

Suggestions, bug reports or improvements can be reported to @tyler@1611.social