Search products

Hybrid (BM25 + k-NN vector) search across the workspace's product catalog. Pass a natural-language query — the backend expands and filters it with an agent when that improves recall. Optional filters support priceMin / priceMax, stockStatus, brand, category, and arbitrary attributes equality. Optional facetFields returns aggregate counts for the requested fields. Use for "find X" style requests; use the chat endpoint instead if you want a conversational answer that cites the products.