anchor.diff:  [[search-rank-eval]]
  -=== Ranking Evaluation API
  +=== Ranking evaluation API
  +++++
  +<titleabbrev>Ranking evaluation</titleabbrev>
  +++++
   
   Allows you to evaluate the quality of ranked search results over a set of 
   typical search queries.
  
positive.code: -----------------------------
  // NOTCONSOLE
  
  <1> the search request's id, used to group result details later 
  <2> the query that is being evaluated
  <3> a list of document ratings, each entry containing the document's `_index` and 
  `_id` together with the rating of the document's relevance with regard to this 
  search request
  
  A document `rating` can be any integer value that expresses the relevance of the 
  document on a user-defined scale. For some of the metrics, just giving a binary 
  
negative.code: [[search-rank-eval-api-path-params]]
  ==== {api-path-parms-title}
  
  `<target>`::
  (Optional, string)
  Comma-separated list of data streams, indices, and index aliases used to limit
  the request. Wildcard (`*`) expressions are supported.
  +
  To target all data streams and indices in a cluster, omit this parameter or use
  `_all` or `*`.
  
  [[search-rank-eval-api-query-params]]
  ==== {api-query-parms-title}
  