Filters

Filter search results by vertical_data fields. Filters narrow the candidate set before vector search.

Exact match

{
  "query": "M8 bolt",
  "filters": {
    "in_stock": true,
    "country": "DE",
    "material": "Stainless Steel A2"
  }
}

Range operators

Use suffixes for numeric range filtering:

{
  "query": "bolt",
  "filters": {
    "price_eur_min": 0.05,
    "price_eur_max": 0.20,
    "in_stock": true,
    "country": "DE"
  }
}

This returns entities where price is between 0.05 and 0.20, in stock, and in Germany.

Combining filters

Multiple filters are combined with AND logic. Maximum 20 filters per query.

Zero-result fallback

If filters produce zero results, QANATIX automatically relaxes all filters and retries. The response metadata.zero_result_fallback_used will be true if this happened.