๐Ÿ”ฅGodFocus Platformยท Docs
โ† HomeDashboard โ†’

Themes

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

Available themes

The API supports 30 themes:

ThemeThemeTheme
salvationlovefaith
hopegraceprayer
forgivenesspeacewisdom
joyrighteousnessredemption
holy_spiritcreationjudgment
covenantworshipdiscipleship
servicehumilitysuffering
perseverancecommunityresurrection
prophecykingdomjustice
mercytruthbaptism

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