facets
booleandefault: falseReturns counts by host, vertical, source, content type, authority, publication year and community.
Facets let an agent understand the shape of a result set before reading any of it — whether the coverage is concentrated in one publisher, spread across years, or dominated by one content type.
That is often enough to decide the next query without spending a single token on document text.
Example
curl -H "x-api-key: $UNLOB_API_KEY" \
"https://api.unlob.com/search?q=quantum+computing&facets=true"Common questions
What does the facets filter do?
Returns counts by host, vertical, source, content type, authority, publication year and community.
When should I use facets?
Exploratory queries, and any agent that decides its own next step.
How does facets behave in practice?
That is often enough to decide the next query without spending a single token on document text.
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.