Bible
Bible Semantic Search
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
Semantic search across the Bible (with UB paragraphs)
curl --request POST \
--url https://api.urantia.dev/bible/search/semantic \
--header 'Content-Type: application/json' \
--data '
{
"q": "blessed are the poor in spirit",
"limit": 2,
"urantiaParallelLimit": 1
}
'import requests
url = "https://api.urantia.dev/bible/search/semantic"
payload = {
"q": "blessed are the poor in spirit",
"limit": 2,
"urantiaParallelLimit": 1
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({q: 'blessed are the poor in spirit', limit: 2, urantiaParallelLimit: 1})
};
fetch('https://api.urantia.dev/bible/search/semantic', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.urantia.dev/bible/search/semantic",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'q' => 'blessed are the poor in spirit',
'limit' => 2,
'urantiaParallelLimit' => 1
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.urantia.dev/bible/search/semantic"
payload := strings.NewReader("{\n \"q\": \"blessed are the poor in spirit\",\n \"limit\": 2,\n \"urantiaParallelLimit\": 1\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.urantia.dev/bible/search/semantic")
.header("Content-Type", "application/json")
.body("{\n \"q\": \"blessed are the poor in spirit\",\n \"limit\": 2,\n \"urantiaParallelLimit\": 1\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.urantia.dev/bible/search/semantic")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"q\": \"blessed are the poor in spirit\",\n \"limit\": 2,\n \"urantiaParallelLimit\": 1\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "Matt.5.3",
"reference": "Matthew 5:3",
"bookCode": "Matt",
"bookName": "Matthew",
"canon": "nt",
"chapter": 5,
"verseStart": 3,
"verseEnd": 3,
"text": "“Blessed are the poor in spirit, for theirs is the Kingdom of Heaven.",
"similarity": 0.840725,
"urantiaParallels": [
{
"id": "4:140.3.3",
"standardReferenceId": "140:3.3",
"paperId": "140",
"paperTitle": "The Ordination of the Twelve",
"sectionTitle": "The Ordination Sermon",
"text": "“Happy are the poor in spirit, the humble, for theirs are the treasures of the kingdom of heaven.",
"similarity": 0.853767,
"rank": 1
}
]
},
{
"id": "Ps.41.1",
"reference": "Psalms 41:1",
"bookCode": "Ps",
"bookName": "Psalms",
"canon": "ot",
"chapter": 41,
"verseStart": 1,
"verseEnd": 1,
"text": "Blessed is he who considers the poor. Yahweh will deliver him in the day of evil.",
"similarity": 0.642814,
"urantiaParallels": [
{
"id": "4:131.2.8",
"standardReferenceId": "131:2.8",
"paperId": "131",
"paperTitle": "The World’s Religions",
"sectionTitle": "Judaism",
"text": "“Yahweh is the God of my salvation; therefore in the divine name will I put my trust. I will trust in the Lord with all my heart; I will lean not upon my own understanding. In all my ways I will acknowledge him, and he shall direct my paths. The Lord is faithful; he keeps his word with those who serve him; the just shall live by his faith. If you do not well, it is because sin lies at the door; men reap the evil they plough and the sin they sow. Fret not yourself because of evildoers. If you regard iniquity in your heart, the Lord will not hear you; if you sin against God, you also wrong your own soul. God will bring every man’s work to judgment with every secret thing, whether it be good or evil. As a man thinks in his heart, so is he.",
"similarity": 0.512232,
"rank": 1
}
]
}
],
"meta": {
"page": 0,
"limit": 2,
"total": 17641,
"totalPages": 8821
}
}{
"type": "https://urantia.dev/errors/not-found",
"title": "Not Found",
"status": 404,
"detail": "Paragraph not found"
}{
"type": "https://urantia.dev/errors/not-found",
"title": "Not Found",
"status": 404,
"detail": "Paragraph not found"
}{
"type": "https://urantia.dev/errors/not-found",
"title": "Not Found",
"status": 404,
"detail": "Paragraph not found"
}Body
application/json
⌘I
Semantic search across the Bible (with UB paragraphs)
curl --request POST \
--url https://api.urantia.dev/bible/search/semantic \
--header 'Content-Type: application/json' \
--data '
{
"q": "blessed are the poor in spirit",
"limit": 2,
"urantiaParallelLimit": 1
}
'import requests
url = "https://api.urantia.dev/bible/search/semantic"
payload = {
"q": "blessed are the poor in spirit",
"limit": 2,
"urantiaParallelLimit": 1
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({q: 'blessed are the poor in spirit', limit: 2, urantiaParallelLimit: 1})
};
fetch('https://api.urantia.dev/bible/search/semantic', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.urantia.dev/bible/search/semantic",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'q' => 'blessed are the poor in spirit',
'limit' => 2,
'urantiaParallelLimit' => 1
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.urantia.dev/bible/search/semantic"
payload := strings.NewReader("{\n \"q\": \"blessed are the poor in spirit\",\n \"limit\": 2,\n \"urantiaParallelLimit\": 1\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.urantia.dev/bible/search/semantic")
.header("Content-Type", "application/json")
.body("{\n \"q\": \"blessed are the poor in spirit\",\n \"limit\": 2,\n \"urantiaParallelLimit\": 1\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.urantia.dev/bible/search/semantic")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"q\": \"blessed are the poor in spirit\",\n \"limit\": 2,\n \"urantiaParallelLimit\": 1\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "Matt.5.3",
"reference": "Matthew 5:3",
"bookCode": "Matt",
"bookName": "Matthew",
"canon": "nt",
"chapter": 5,
"verseStart": 3,
"verseEnd": 3,
"text": "“Blessed are the poor in spirit, for theirs is the Kingdom of Heaven.",
"similarity": 0.840725,
"urantiaParallels": [
{
"id": "4:140.3.3",
"standardReferenceId": "140:3.3",
"paperId": "140",
"paperTitle": "The Ordination of the Twelve",
"sectionTitle": "The Ordination Sermon",
"text": "“Happy are the poor in spirit, the humble, for theirs are the treasures of the kingdom of heaven.",
"similarity": 0.853767,
"rank": 1
}
]
},
{
"id": "Ps.41.1",
"reference": "Psalms 41:1",
"bookCode": "Ps",
"bookName": "Psalms",
"canon": "ot",
"chapter": 41,
"verseStart": 1,
"verseEnd": 1,
"text": "Blessed is he who considers the poor. Yahweh will deliver him in the day of evil.",
"similarity": 0.642814,
"urantiaParallels": [
{
"id": "4:131.2.8",
"standardReferenceId": "131:2.8",
"paperId": "131",
"paperTitle": "The World’s Religions",
"sectionTitle": "Judaism",
"text": "“Yahweh is the God of my salvation; therefore in the divine name will I put my trust. I will trust in the Lord with all my heart; I will lean not upon my own understanding. In all my ways I will acknowledge him, and he shall direct my paths. The Lord is faithful; he keeps his word with those who serve him; the just shall live by his faith. If you do not well, it is because sin lies at the door; men reap the evil they plough and the sin they sow. Fret not yourself because of evildoers. If you regard iniquity in your heart, the Lord will not hear you; if you sin against God, you also wrong your own soul. God will bring every man’s work to judgment with every secret thing, whether it be good or evil. As a man thinks in his heart, so is he.",
"similarity": 0.512232,
"rank": 1
}
]
}
],
"meta": {
"page": 0,
"limit": 2,
"total": 17641,
"totalPages": 8821
}
}{
"type": "https://urantia.dev/errors/not-found",
"title": "Not Found",
"status": 404,
"detail": "Paragraph not found"
}{
"type": "https://urantia.dev/errors/not-found",
"title": "Not Found",
"status": 404,
"detail": "Paragraph not found"
}{
"type": "https://urantia.dev/errors/not-found",
"title": "Not Found",
"status": 404,
"detail": "Paragraph not found"
}
