OptionalcolumnsColumn names to include in each result row.
OptionalcolumnsColumns whose values are sent to the reranker.
OptionalfacetsFacets to compute over the matched results (e.g. "category TOP 5").
OptionalfiltersJSON string describing query filters (e.g. {"id >": 5}).
OptionalmaxMaximum number of results to return (the legacy num_results). Defaults to 10.
OptionalnameFull resource name of the index to query.
Format: workspaces/{workspace_id}/endpoints/{endpoint_id}/indexes/{index_id}
OptionalqueryText columns to search for query_text. When empty, all text columns are searched.
OptionalqueryQuery text. Required for Delta Sync indexes that compute embeddings from a model endpoint.
OptionalqueryQuery type: ANN, HYBRID, or FULL_TEXT. Defaults to ANN.
OptionalqueryQuery vector. Required for Direct Access indexes and Delta Sync indexes with self-managed vectors.
OptionalrerankerIf set, results are reranked before being returned.
OptionalscoreScore threshold for the approximate nearest-neighbor search. Defaults to 0.0.
OptionalsortSort clauses, e.g. ["rating DESC", "price ASC"]. Overrides relevance ordering.
Request to query (search) an AI Search index. The legacy
num_resultscount is exposed asmax_results; v1 returns up tomax_resultsrows in a single response (no cursor pagination — see the note onmax_resultsbelow).