Query filters
27 filters, all evaluated against stored fields. Filtering narrows the candidate set before scoring, so a heavily filtered query is frequently faster than an unfiltered one.
Scope
Which slice of the index the query is allowed to touch.
Time
Two different clocks: when we fetched it, and when it was published.
Quality & trust
Floors on authority, quality, centrality and corroboration.
termstringRequires an exact salient term to be present — the needle that semantic search would smooth away.
min_host_rankfloatSets a floor on the authority of the publishing host.
min_qualityintegerSets a floor on the passage quality score assigned at admission.
min_centralityfloatRequires a minimum graph centrality — how load-bearing a passage is in its neighbourhood.
min_independent_sourcesintegerRequires the passage’s story to be carried by at least N distinct hosts.
communitystring[]Restricts results to one or more graph communities.
authoritystring[]Filters by the institutional class of the domain.
Shape
What kind of page, how long, in what language.
langstringRestricts results to one language; `langs[]` accepts several.
content_typestring[]Restricts results to particular kinds of page.
topicstring[]Filters by topic tags assigned at index time.
tldstring[]Restricts results by top-level domain.
safebooleanDrops explicit content. On by default.
min_words / max_wordsintegerBounds passage length in words.
Output
Ordering, deduplication, facets and field projection.
modekeyword | semantic | hybridChooses the retrieval strategy: lexical, vector, or both fused by reciprocal rank.
sortstringOrders results by relevance, time, authority, quality, length or graph centrality.
collapsenone | host | page | storyDeduplicates the result set by host, page or story cluster.
facetsbooleanReturns counts by host, vertical, source, content type, authority, publication year and community.
fieldsstring[]Projects only the fields you need onto each hit.
limitintegerNumber of hits to return. Zero returns the count only.
prefer_recentbooleanBiases ranking toward newer passages without excluding older ones.
prefer_authoritybooleanBiases ranking toward higher-authority hosts without excluding the rest.
Try them
10,000 free requests a month, no card. Filtering aggressively usually improves agent output as well as reducing cost.
