Introduction to the ESV API
Want to use the text of the ESV on your website?
Crossway allows you to access the ESV Bible text from our server and include it on your website, free of charge for non-commercial use.
How does it work?
This service, like most web services, requires that you have access to a programming language on your web server, such as Python, Perl, PHP, or ASP, as well as basic knowledge of how to program in that language. You won’t be able to access the service using only HTML.
What are the conditions of use for the text?
- You may request up to 500 verses per query, or half a book, whichever is less (excepting single-chapter books).
- You may only perform 5,000 queries per day, with no more than 1,000 requests in an hour and no more than 60 request per minute. If you exceed these limits, your application will be throttled.
- You may not locally store more than 500 consecutive verses or one-half of any book of the Bible (whichever is less).
- The text may be redistributed further (for example, via email or an RSS feed). You may distribute up to 500 verses, as long as the verses quoted do not amount to 50% of a complete book of the Bible and do not make up 50% or more of the total text of the work in which they are quoted.
- You may not display more than 500 consecutive verses or one-half of any book (whichever is less) on any page.
- You must use the text for non-commercial purposes, and your website must be non-commercial. (For a definition of “non-commercial,” please see below.) This service is intended primarily for personal, church, and Christian ministry organization use. For other purposes, see below.
- Your website must not be engaged in illegal or immoral activity. Crossway is not responsible for any copyrights infringed by the service’s users (for example, if a copyrighted reading plan is used without permission. Reading plans offered directly through the service are used with permission).
- You must include the standard ESV copyright notice on your site (see below) and identify the passages as coming from the ESV. Each page on which you use the text must include a link to www.esv.org.
- You may not sell, share, or publish your access key.
- We reserve the right to cancel your access to the service at any time for any reason.
- This service is available for use only by individuals and non-commercial organizations that use the service in ways consistent with the historic Christian understanding of doctrine and the Bible, as summarized in the following foundational doctrines. (See our statement of faith.)
- The Bible is the inspired, inerrant Word of God.
- There is one God, the Creator of all things, who exists eternally in three persons--Father, Son, and Holy Spirit.
- Jesus Christ is fully God and fully man; he died on the cross, rose from the dead, ascended to heaven, and will come again.
- Salvation is by grace alone, through faith alone, in Christ alone.
- You agree to maintain the moral integrity, spirit, fervor, and consistency in message that is inherent in the nature of the ESV Bible. This means that your use is consistent with the above statement of faith and that you give proper attribution.
Can I cache the text locally?
You can cache up to 500 consecutive verses. We encourage you to periodically clear out your cache to ensure that you always have the latest version of the text, and that any bug-fixes we’ve applied to the service will be reflected in the content you receive.
Can I change the text?
You may not change any of the words in the text. You may choose to omit certain features, such as headings, footnotes, cross-references, and verse numbers. You may also omit portions of verses or sections quoted if you include an ellipsis (…) indicating that you are omitting them, and only if such omissions do not change the meaning of the verses or sections being quoted.
What if I want to use the text of the ESV in an email devotional? Can I do that?
Yes, if the text amounts to fewer than 500 verses or 50% of any book of the Bible, and if the text comprises less than 50% of the email. For example, you could not have a "read through the Bible" email unless you also included other text.
What interfaces are available?
Currently, we have a REST interface. We chose REST because it’s easy to use and to implement. If we find that demand warrants other interfaces, we may implement them in the future.
What formats are available?
The ESV is available in plain text and HTML.
What is the standard copyright notice I need to include on my website?
On pages that use the ESV text, you must include any copyright notice that is sent with the text. With each quotation, include the letters "ESV." (These letters are included by default with each request. They do not have to be a link.) On a "copyright" page of your website, you need to include one of the following:
- Scripture quotations are from the ESV® Bible (The Holy Bible, English Standard Version®), copyright © 2001 by Crossway, a publishing ministry of Good News Publishers. Used by permission. All rights reserved. You may not copy or download more than 500 consecutive verses of the ESV Bible or more than one half of any book of the ESV Bible.
- Scripture quotations marked "ESV" are from the ESV® Bible (The Holy Bible, English Standard Version®), copyright © 2001 by Crossway, a publishing ministry of Good News Publishers. Used by permission. All rights reserved. You may not copy or download more than 500 consecutive verses of the ESV Bible or more than one half of any book of the ESV Bible.
- Unless otherwise indicated, all Scripture quotations are from the ESV® Bible (The Holy Bible, English Standard Version®), copyright © 2001 by Crossway, a publishing ministry of Good News Publishers. Used by permission. All rights reserved. You may not copy or download more than 500 consecutive verses of the ESV Bible or more than one half of any book of the ESV Bible.
What if I want to use the API in another way?
To request information on including the ESV in your mobile app or for other usage, please describe your application via email to firstname.lastname@example.org.
What do you mean by “non-commercial website” and “non-commercial purposes?”
A non-commercial site does not charge for access to any part of the site. Further, no charge is made for access to the ESV text.
In contrast, a commercial website is primarily designed to motivate visitors to buy something, to pay for a service, or to give a donation, or it accepts advertising or sponsorships.
This service is designed to be used for personal, church, and ministry organization use.
If I just want to link to the ESV text (to display a passage, for example), and don't want the text to appear integrated into my website, should I use this service?
Although you can use this service, it's much easier simply to link to us.
What could I use the text for?
- A daily devotional.
- Display the passage that corresponds to this week’s sermon.
- Create an application that automatically adds the text of a passage to a webpage when you type its reference.
- Link to a page on your own website when you want to display a Bible passage instead of linking to an external site.
- Create your own Bible search engine for use on your own website.
What guarantees do you offer?
We guarantee that the text we send you is the official version of the ESV Bible. We do not guarantee that the service will always be available, nor are we responsible for any damage to your computer systems as a result of this service. You are responsible for maintaining the security and integrity of your systems.
Can I terminate my access? Can you revoke it?
You are free to terminate your relationship with us at any time. Please email email@example.com to have your application and contact information removed from our system.
We can revoke your access key if, in our sole judgment, you do not abide by the terms of this agreement or we decide to discontinue the service.
What will you use my email address for?
We will not share your email address with any organization. We will only use it to contact you about your account and to keep you informed about any news about or changes to the service (e.g., scheduled maintenance or API changes).
What is the API (Application Program Interface)?
For details on the API, please visit our API page.