@amanda-mitchell/esv-api
v2.0.2@amanda-mitchell/esv-api
This is a Javascript client for Crossway's ESV API.
Installation
yarn add @amanda-mitchell/esv-api
Usage
import { createEsvApiClient } from '@amanda-mitchell/esv-api';
// This can be any method that is compatible with the Fetch interface.
import fetch from 'node-fetch';
const apiKey =
'Go to https://api.esv.org/ to register an application and get an API key.';
const client = createEsvApiClient({ apiKey, fetch });
client
.content({
passage: 'Genesis 1:1',
format: 'txt',
bible: 'leb',
})
.then(console.log)
.catch(console.error);
Available methods
Each of these methods takes two parameters: a query
string, and an optional options
hash containing the keys corresponding to the official API docs.
To make consumption in JS easier, each option has been converted to camel case.
For example, rather than include-passage-references
, this client accepts an includePassageReferences
key.
With the exception of passageAudio
, each endpoint returns a Javascript object representing the parsed JSON of the response.
passageText
: retrieve Bible text as plain text.passageHtml
: retrieve Bible text as html.passageAudio
: retrieve Bible text as an MP3.passageSearch
: search for specific text in the Bible.
npm i @amanda-mitchell/esv-api
Metadata
- MIT
- Whatever
- Amanda Mitchell
- released 3/8/2022