Bible Search AI

POST/v1/bible/search-ai3 credits

Semantic (embedding-based) scripture search. More powerful than keyword search — understands the meaning of your query rather than just matching words.

When to use this vs. /v1/bible/search

Use /v1/bible/search for exact keyword matching (fast, 1 credit). Use /v1/bible/search-ai when you need semantic understanding — e.g. "God's love for the world" should find John 3:16 even though the words don't literally match.

Request body

{
  "query": "God's love for the world",
  "top_k": 5,
  "theme": "love"
}

Field	Type	Required	Description
query	string	Yes	Natural language query (max 500 chars)
top_k	number	No	Max results (1–50, default 10)
theme	string	No	Filter to a biblical theme

Response

{
  "verses": [
    {
      "reference": "John 3:16",
      "text": "For God so loved the world that he gave his one and only Son...",
      "score": 0.97
    },
    {
      "reference": "Romans 5:8",
      "text": "But God shows his love for us in that while we were still sinners, Christ died for us.",
      "score": 0.94
    }
  ],
  "creditsUsed": 3
}

Example

curl -X POST https://platform.godfocus.io/v1/bible/search-ai \
  -H "Authorization: Bearer $GODFOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "God'"'"'s love for the world", "top_k": 5, "theme": "love"}'