Bible

Semantic search across the Bible (with UB paragraphs)

Changed on

Free-form natural-language search across all 17,641 Bible chunks. Each result includes the top-N pre-computed Urantia paragraphs related to that chunk via the existing cross-reference data, so a single query surfaces both the Bible matches and the relevant UB content.

Query is embedded via text-embedding-3-small (1536-d) and matched against bible_chunks.embedding_small with a pgvector HNSW index. Latency is ~50-100ms on cache miss for the embedding call, ~30ms cached.

Optional filters: canon (ot, deuterocanon, nt), bookCode (any OSIS/USFM/full-name/alias). urantiaParallelLimit controls how many UB paragraphs to attach per result (0-10, default 3). Set to 0 to suppress.

post/bible/search/semantic

Request

  • Base URL: https://api.urantia.dev
  • URL: https://api.urantia.dev/bible/search/semantic
  • Auth: none required

Request body

qstring required
pageinteger
limitinteger
canon'ot' | 'deuterocanon' | 'nt'
bookCodestring
urantiaParallelLimitinteger

Response

Bible semantic search results

Changes

  • a7d08cd0de9fRevision changes
    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      added the non-success response with the status

  • d3ff6b5fe824Revision changes
    • breaking

      request body became required