Themes

Filter scripture results by biblical theme to get more focused, relevant verses.

Available themes

The API supports 30 themes:

Theme	Theme	Theme
salvation	love	faith
hope	grace	prayer
forgiveness	peace	wisdom
joy	righteousness	redemption
holy_spirit	creation	judgment
covenant	worship	discipleship
service	humility	suffering
perseverance	community	resurrection
prophecy	kingdom	justice
mercy	truth	baptism

Using the theme parameter

Pass theme as a string in your request body alongside your query:

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

The theme parameter is optional. If omitted, search runs across all themes.

Which endpoints support themes?

/v1/bible/search — keyword search with theme filter
/v1/bible/search-ai — semantic search with theme filter
/v1/bible/ask — RAG answer scoped to a theme

Theme behavior

When theme is provided, results are pre-filtered to verses tagged with that theme before ranking. This means:

Fewer results overall (bounded to that theme's verse set)
Higher topical precision
If the theme has fewer than top_k tagged verses, you may get fewer results than requested