Bible Search

POST/v1/bible/search1 credit

Keyword-based scripture search. Returns the top matching Bible verses for a given query.

Request body

{
  "query": "love thy neighbor",
  "top_k": 10,
  "theme": "love"
}

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

Response

{
  "verses": [
    {
      "reference": "Matthew 22:39",
      "text": "And the second is like it: Love your neighbor as yourself.",
      "score": 0.95
    }
  ],
  "creditsUsed": 1
}

Field	Type	Description
verses	array	Array of matching verse objects
verses[].reference	string	Book, chapter, and verse (e.g. "John 3:16")
verses[].text	string	Full verse text
verses[].score	number	Relevance score 0–1
creditsUsed	number	Credits deducted (always 1)

Example

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