IMPORTANT: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
current release documentation.
Search API precision (beta)
editSearch API precision (beta)
editThis functionality is in beta. Beta features are subject to change and are not covered by the support SLA of general release (GA) features. Elastic plans to promote this feature to GA in a future release.
Precision tuning has no effect in queries that contain synonyms.
Use the precision
parameter of the search API to tune precision and recall for a query.
Learn more in Precision tuning (beta).
The value of the precision
parameter must be an integer between 1
and 11
, inclusive.
The range of values represents a sliding scale that manages the inherent tradeoff between precision and recall.
Lower values favor recall, while higher values favor precision.
See Precision tuning values for a description of all possible values.
Request template
editGET <ENTERPRISE_SEARCH_BASE_URL>/api/as/v1/engines/{ENGINE_NAME}/search { "query": "{STRING}", "precision": {INTEGER} }
Example response (200)
edit# 200 OK { "meta" : { # ... "precision" : 3, # ... }, "results" : [ # ... ] }
Example response (400)
edit# 400 Bad Request { "errors": [ "Precision must be an integer between 1 and 11" ] }