★LIVE

Embeddable Widget

Add hover/tap Bible tooltips to any website with one <script> tag. Verse references (e.g. John 3:16) and the names of biblical people, places, and things are detected automatically and show a preview on hover (desktop) or tap (mobile) — the actual verse text, or a short person/place/thing summary — without the reader leaving the page. Configure your snippet below, copy it, and paste it before </body>.

Build your snippet

Don’t have a key? Get one free → · already have one? copy it from your dashboard →

YOUR SNIPPET
<script src="https://scripture.bible/embed/v1"
  data-bible-key="YOUR_API_KEY"></script>

Live preview

Hover (or tap) the highlighted references and names below — these tooltips are produced by the real widget with your settings.

Want manual control?

Set data-autodetect="off" and tag elements yourself: <span data-bible-verse="John 3:16">, data-bible-person="david", data-bible-place="jerusalem", data-bible-thing="ark-of-the-covenant". Add data-bible-ignore to any element to skip it.

Query Parameters

data-bible-keyreq
string

Your API key (bapi_…). Required on third-party sites — it authenticates the preview/index requests and applies your rate limit. Get one free at /register.

data-bible-translation
string

Translation for verse previews: WEB (default), KJV, KJVA, or AKJV.

data-bible-theme
string

auto (default — follows the visitor's OS setting) | light | dark.

data-bible-scope
string

A CSS selector to limit detection to part of the page, e.g. article or .post-body. Default: the whole page.

data-autodetect
string

all (default — verses + people/places/things) | verses (references only) | off (only elements you tag yourself).

data-bible-min
number

Minimum mention count for an entity name to auto-link. Raise it to reduce noise. Default: 0.

data-bible-stoplist
string

Comma-separated words that should never auto-link, added to the built-in stoplist.

Endpoints

GET
/embed/v1

The widget script itself — self-contained, ~13KB, zero dependencies. Load it with a <script> tag.

LIVE
GET
/api/v1/preview?ref={reference}

Lightweight single-verse preview the tooltip fetches on hover.

LIVE
GET
/api/v1/{people|places|things}/{slug}?preview=1

Lightweight person/place/thing preview the tooltip fetches on hover.

LIVE
GET
/api/v1/embed/index

The detection dictionary (book + entity names + mention counts) the widget downloads once.

LIVE