Search across all indexed FlexOrch datasets by keyword or meaning.
Use this to find specific documents or records without processing a new file.
Requires at least one dataset to exist. Structured search works on all plans.
Semantic and hybrid modes require a Pro plan — a clear upgrade message is returned
if the plan is insufficient. mode='auto' picks structured on free plans, hybrid on Pro+.
Args:
query: Search query — natural language or keyword. Max 1000 characters.
top_k: Number of results to return. Default: 5, max: 50.
mode: Search strategy — auto (default), structured, semantic, hybrid.
semantic and hybrid require Pro plan.
document_type: Filter to a specific document type, e.g. invoice (optional).
language: Filter by document language, ISO 639-1 code, e.g. en, de, tr (optional).
quality_grade: Filter by quality grade: A, B, C, or D (optional).