ESV API Overview

The ESV API provides access to the ESV text, with a customizable presentation in multiple formats. You will need an HTTP client in your programming language of choice to use the API.

To obtain an API key, you will first need to create an API Application.

Authorization

When making requests, you will need to include your application's key with each request in the Authorization header like this:

Authorization: Token YOUR_API_KEY

Endpoints

We provide the following API endpoints:

• /v3/passage/text/ for plain text
• /v3/passage/html/ for HTML
• /v3/passage/audio/ for audio files
• /v3/passage/search/ for searching the ESV text

These endpoints support many optional parameters, but q (your passage query) is the only one that's required.

Sample Projects

We've created a few sample projects to help you get started with our API. Each is implemented in Python 3 and intended to be run on the command line.

See our API Sample Projects page for details.