Skip to content
unlob

topic

string[]

Filters by topic tags assigned at index time.

A twelve-way coarse classification applied to every passage. Less precise than a vertical, but it works across verticals — useful when the same subject appears in news, documentation and academic writing.

Accepted values

  • technology
  • science
  • health
  • finance
  • politics
  • business
  • sports
  • entertainment
  • food
  • travel
  • education
  • lifestyle

The live vocabulary is served by /describe — read it rather than hardcoding this list.

Example

topicbash
curl -H "x-api-key: $UNLOB_API_KEY" \
  "https://api.unlob.com/search?q=interest+rates&topic[]=finance"

Common questions

What does the topic filter do?

Filters by topic tags assigned at index time.

When should I use topic?

Cross-vertical subject filtering, or building a topic-scoped feed.

Filters are free

Every filter is evaluated against a stored field, so it narrows the candidate set before scoring — a filtered query is often faster than an unfiltered one.