# KJV API

KJV accessible via web calls

### Usage

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

- /salvation - Learn what you have to do to go to heaven.
- /random - A random verse from the KJV
- /votd - A random verse that changes from day-to-day.
- /search - Search keywords
- /show - Show a set of verses
- /define - Search the Dictionary

### Verse searching

'/show?kw=' will try to match single verses and verse ranges. (not sets) For example:

    /show?kw=john3:16
    /show?kw=1 John 3:3- (gets the whole rest of the chapter)

### Keyword searching

'/search?kw=keyword' accepts a search word, and will return any verses matching the query. For example:

### 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'));

    API ENDPOINT SPECIFICATION v 0.2
    ================================

    /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
    /define - 1828 Noah Webster dictionary

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

    ?kw=
    - comma-delimited keyword search for /search

    INTERACTIVE ENDPOINTS
    =====================
    /search and /define will show you a landing page where you can
    use HTML forms to complete your search. Both of these will
    offer you spelling suggestions if it can't find the right word.
    This will only offer words that are actually in the Bible.

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

### Bugs

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