Bibleserver.com for Webmasters

The developer tools of the Bibleserver support you with the manual and automatic link of Bible passages on your website. The official API of the Bibleserver will be explained in detail below.

Note: The Bibleserver doesn’t offer API for the content of Bible verses. This is not possible due to license reasons.

The link structure of the Bible server is simple and clear. Without prior experience, any Bible passage or search result can be linked with the Bibleserver. With the current version 2010 of the Bibleserver, the linking has changed. However, links made with former versions still work.

Link Bible passages

The link of a Bible passage has the following structure:
https://www.bibleserver.com/text/{Translation}/{Bible passage}

Example for John 3:16 from the Luther translation:
https://www.bibleserver.com/text/LUT/Johannes3,16

It is also possible to link a translation comparison:
https://www.bibleserver.com/text/LUT.ELB.EU/Johannes3,16

Link search queries

Search queries can be linked as follows:
https://www.bibleserver.com/search/{Translation}/{Search term}

Example for "Tempel" from the Luther translation:
https://www.bibleserver.com/search/LUT/Tempel

Search queries with translation comparison can be linked as follows:
https://www.bibleserver.com/search/LUT.ELB.EU/Tempel

Explanations on how to state the translation

Translations are indicated in shortened form. The following table gives an overview of available translations.

Overview of available translations
Abbreviation Name Language Section
LUTLutherbibel 2017GermanOT, NT, Apocrypha
ELBElberfelder BibelGermanOT, NT
HFAHoffnung für AlleGermanOT, NT
SLTSchlachter 2000GermanOT, NT
ZBZürcher BibelGermanOT, NT
NGÜNeue Genfer ÜbersetzungGermanPsalms, NT
GNBGute Nachricht BibelGermanOT, NT, Apocrypha
EUEinheitsübersetzung 2016GermanOT, NT, Apocrypha
ESVEnglish Standard VersionEnglishOT, NT
NLBNeues Leben. Die BibelGermanOT, NT
NIVNew International VersionEnglishOT, NT
NeÜNeue evangelistische ÜbersetzungGermanOT, NT
MENGMenge BibelGermanOT, NT, Apocrypha
NIRVNew Int. Readers VersionEnglishOT, NT
KJVKing James VersionEnglishOT, NT
BDSBible du SemeurFrenchOT, NT
S21Segond 21FrenchOT, NT
ITALa Parola è VitaItalianNT
NRSNuova Riveduta 2006ItalianOT, NT
HTBHet BoekDutchOT, NT
LSGLouis Segond 1910FrenchOT, NT
CSTNueva Versión Internacional (Castilian)SpanishOT, NT
NVINueva Versión InternacionalSpanishOT, NT
BTXLa Biblia TextualSpanishOT, NT
PRTO LivroPortugueseOT, NT
NOREn Levende BokNorwegianNT
BSVNya Levande BibelnSwedishOT, NT
DKBibelen på hverdagsdanskDanishOT, NT
PSZSłowo ŻyciaPolishNT
CEPČeský ekumenický překladCzechOT, NT, Apocrypha
SNCSlovo na cestuCzechOT, NT
B21Bible, překlad 21. stoletíCzechOT, NT, Apocrypha
BKRBible KralickáCzechOT, NT
NPKNádej pre kazdéhoSlovakNT
KARIBS-fordítás (Új Károli)HungarianOT
HUNHungarianHungarianNT
NTRNoua traducere în limba românãRomanianOT, NT
BGVВеренBulgarianOT, NT
CBTБиблия, нов превод от оригиналните езициBulgarianOT, NT, Apocrypha
CKKKnjiga O KristuCroatianNT
RSZНовый перевод на русский языкRussianOT, NT
CARSСвященное Писание, Восточный переводRussianOT, NT
TRTürkçeTurkishOT, NT
NAVKetab El HayatArabicOT, NT
FCBکتاب مقدس، ترجمه تفسیریFarsiOT, NT
CUVS中文和合本(简体)ChineseOT, NT
CCBT聖經當代譯本修訂版ChineseOT, NT
OTHebrew OT-OT
LXXSeptuaginta-OT
VULVulgata-OT

Explanations on how to state the particulate Bible passage

The Bibleserver recognizes all common spellings of a Bible passage. Furthermore, several verses at once can be linked. In order to avoid problems, please use the language of the respective translation when stating the Bible passage.

The Bibleserver offers an interface on the server side by which Bible verses within a text will automatically be recognized and linked. Stating API key is required in order to use the interface. The number of the daily API requests is limited. For this reason, it is recommended to parse the Bible passages while saving the text.

The API is available at https://www.bibleserver.com/api/parser.
The following parameters can be passed per GET or POST:

The following PHP example shows how to use the API on the server side:

// Define POST data
$text = 'Read John 3:16 in the Bible.';
$param = array(
    'key' => 'YOUR_API_KEY',
    'text' => $text,
    'lang' => 'en',
    'trl' => 'LUT'
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.bibleserver.com/api/parser');
curl_setopt($ch, CURLOPT_REFERER, 'http://'.$_SERVER['SERVER_NAME']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $param);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$result = curl_exec($ch);
$httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if ($httpcode === 200) {
    $text = $result;
}

curl_close($ch);

Result of the PHP example:

Read John 3:16 in the Bible.

The JavaScript implementation of the API allows the recognition and linking of Bible passages in the browser. Stating API key is required in order to use the JavaScript API.

Note: The JavaScript implementation is a simplified version of the API on the server side. Maybe not every Bible passage will be recognized correctly. Furthermore, problems with JavaScript events may arise due to DOM manipulations.

The following HTML/JavaScript example shows how to use the API on the client side:

<!doctype html>
<html>
<head>
    <title>[...]</title>

    <!-- The following script needs to be adapted and integrated to your website. -->
    <script type="text/javascript">
    (function() {
        var ga = document.createElement('script');
        ga.src = 'https://www.bibleserver.com/api/parser.js?key=YOUR_API_KEY&lang=de';
        ga.setAttribute('async', 'true');
        document.documentElement.firstChild.appendChild(ga);
    })();

    var bsQuery = '.article'; // jQuery selector for wrapper of search (optional)
    var bsTrl   = 'LUT';      // Linked translation (optional)
    </script>

</head>
<body>
    [...]
    <h1>Johannes 3</h1>
    <div class="article">
        Read John 3:16 in the Bible.
    </div>
    [...]
</body>
</html>

Result of the JavaScript example:

Johannes 3
Read John 3:16 in the Bible.

Parameter for calling the API:

Additional JavaScript options:

Wordpress plugin

The Wordpress plugin "Link to Bible" automatically links Bible verses to Bibleserver.com when saving the article. Please find further information on the plugin website.

Create API key

In order to automatically link Bible passages either on the client side or on the server side, an API key is required. This key depends on the domain and can be ordered here.

My domain:

Note: Bibleserver.com maintains the right to limit the daily API accesses per domain.

Privacy Policy BibleServer API

Your privacy is important to us!

Therefore, no personal data will be stored while using the BibleServer API. However, we offer an API, which enables you to link passages of scripture to BibleServer. The client-side automatic linking which is executed on your device and communicates with our server does not submit any content to BibleServer.

However, when using the server-side automatic linking contents will be transmitted to BibleServer. For the linking of Bible passages these data will analyzed, processed and transmitted back to the client by algorithms on our webserver. None of the transmitted data will be saved or passed on to third parties, though. In order to continually develop the website and analyze errors only statistical data like time and length of API calls will be saved for a duration of 120 days.

Legal basis for the use of the server-side linking is art 6 section 1, page 1 lit. f of the GDPR.