Content API

The Content service is the core of GospeLib. It serves scripture text, lexicon entries, topical guides, knowledge graph queries, full-text search, and manuscript witness data from FalkorDB.

Auto-Generated Reference Coming Soon

Full interactive API reference will be auto-generated from api/content.openapi.json using docusaurus-plugin-openapi-docs. The content below is a summary of available endpoint groups.

Endpoint Groups

Passages

Retrieve scripture passages by book, chapter, and verse.

GET /api/v1/passages/{passageId}                 # Single passage (e.g. gen.1.1)
GET /api/v1/passages/{bookId}/{chapter}           # Full chapter
GET /api/v1/passages/{bookId}/{chapter}/{verse}   # Specific verse

Query parameters:

Parameter	Type	Description
include_witnesses	boolean	Include manuscript witnesses
include_words	boolean	Include word-level alignment (interlinear)
include_cross_refs	boolean	Include linked cross-references
include_commentary	boolean	Include verse commentary
translation	string	Translation variant: kjv (default), jst

Lexicon

Look up Hebrew and Greek lexicon entries by word ID or Strong's number.

GET /api/v1/lexicon/{wordId}                     # Word entry (e.g. H7225)
GET /api/v1/lexicon/strongs/{strongsId}           # By Strong's number
GET /api/v1/lexicon/search?q=...                  # Search lemmas/glosses

Topics

Browse the Topical Guide and explore topic relationships.

GET /api/v1/topics                               # List all TG topics
GET /api/v1/topics/{topicId}                     # Topic with passage list
GET /api/v1/topics/{topicId}/subgraph            # Topic + related topics subgraph

Bible Dictionary

GET /api/v1/dictionary/{entryId}
GET /api/v1/dictionary/search?q=...

Knowledge Graph

Query the scripture knowledge graph for connections between any node types.

GET /api/v1/connections/{nodeId}                 # Connections from any node
GET /api/v1/connections/{nodeId}/subgraph        # N-hop neighborhood

Manuscript Witnesses

Compare Book of Mormon manuscript witnesses — Original Manuscript, Printer's Manuscript, and 1830 edition.

GET /api/v1/witnesses/{passageId}                # All witnesses for a passage
GET /api/v1/witnesses/{passageId}/diff           # Diff between witnesses

Search

Full-text and vector similarity search across all content types.

GET /api/v1/search?q=...&type=passages|topics|lexicon|all
GET /api/v1/search/semantic?q=...                # Vector similarity (Phase 2)

Response Format

All responses follow the standard response envelope. Passage responses include the text content along with any requested enrichments (witnesses, words, cross-references, commentary).

Authentication

Most Content API endpoints are publicly accessible. Plan-gated features (such as interlinear data and manuscript witnesses) require a valid subscription — see Billing API for entitlement details.