Query parameters
-
allow_no_indices boolean
If
false
, the request returns an error if any wildcard expression, index alias, or_all
value targets only missing or closed indices. This behavior applies even if the request targets other open indices. -
all_shards boolean
If
true
, the validation is executed on all shards instead of one random shard per index. -
analyzer string
Analyzer to use for the query string. This parameter can only be used when the
q
query string parameter is specified. -
analyze_wildcard boolean
If
true
, wildcard and prefix queries are analyzed. -
default_operator string
The default operator for query string query:
AND
orOR
.Values are
and
,AND
,or
, orOR
. -
df string
Field to use as default where no field prefix is given in the query string. This parameter can only be used when the
q
query string parameter is specified. -
expand_wildcards string | array[string]
Type of index that wildcard patterns can match. If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. Supports comma-separated values, such as
open,hidden
. Valid values are:all
,open
,closed
,hidden
,none
. -
explain boolean
If
true
, the response returns detailed information if an error has occurred. -
ignore_unavailable boolean
If
false
, the request returns an error if it targets a missing or closed index. -
lenient boolean
If
true
, format-based query failures (such as providing text to a numeric field) in the query string will be ignored. -
rewrite boolean
If
true
, returns a more detailed explanation showing the actual Lucene query that will be executed. -
q string
Query in the Lucene query string syntax.
Body
-
query object
Hide query attributes Show query attributes
-
bool object
Hide bool attributes Show bool attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
filter object | array[object]
The clause (query) must appear in matching documents. However, unlike
must
, the score of the query will be ignored.minimum_should_match number | string
The minimum number of terms that should match as integer, percentage or range
must object | array[object]
The clause (query) must appear in matching documents and will contribute to the score.
must_not object | array[object]
The clause (query) must not appear in the matching documents. Because scoring is ignored, a score of
0
is returned for all documents.should object | array[object]
The clause (query) should appear in the matching document.
-
-
boosting object
Hide boosting attributes Show boosting attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Floating point number between 0 and 1.0 used to decrease the relevance scores of documents matching the
negative
query.
-
-
combined_fields object
Hide combined_fields attributes Show combined_fields attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
Text to search for in the provided
fields
. Thecombined_fields
query analyzes the provided text before performing a search. -
If true, match phrase queries are automatically created for multi-term synonyms.
-
operator string
Values are
or
orand
. minimum_should_match number | string
The minimum number of terms that should match as integer, percentage or range
-
zero_terms_query string
Values are
none
orall
.
-
-
constant_score object
Hide constant_score attributes Show constant_score attributes
-
dis_max object
Hide dis_max attributes Show dis_max attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
One or more query clauses. Returned documents must match one or more of these queries. If a document matches multiple queries, Elasticsearch uses the highest relevance score.
-
tie_breaker number
Floating point number between 0 and 1.0 used to increase the relevance scores of documents matching multiple query clauses.
-
distance_feature object
One of: Hide attributes Show attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Date or point of origin used to calculate distances. If the
field
value is adate
ordate_nanos
field, theorigin
value must be a date. Date Math, such asnow-1h
, is supported. If the field value is ageo_point
field, theorigin
value must be a geopoint. -
Distance from the
origin
at which relevance scores receive half of theboost
value. If thefield
value is adate
ordate_nanos
field, thepivot
value must be a time unit, such as1h
or10d
. If thefield
value is ageo_point
field, thepivot
value must be a distance unit, such as1km
or12m
. -
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
Hide attributes Show attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
origin object | array[number] | string Required
A latitude/longitude as a 2 dimensional point. It can be represented in various ways:
- as a
{lat, long}
object - as a geo hash value
- as a
[lon, lat]
array - as a string in
"<lat>, <lon>"
or WKT point formats
- as a
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
Hide attributes Show attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
A duration. Units can be
nanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value. -
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
-
exists object
Hide exists attributes Show exists attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
-
function_score object
Hide function_score attributes Show function_score attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
boost_mode string
Values are
multiply
,replace
,sum
,avg
,max
, ormin
. -
functions array[object]
One or more functions that compute a new score for each document returned by the query.
Hide functions attributes Show functions attributes object
-
filter object
-
weight number
-
field_value_factor object
-
random_score object
-
script_score object
-
-
max_boost number
Restricts the new score to not exceed the provided limit.
-
min_score number
Excludes documents that do not meet the provided score threshold.
-
query object
-
score_mode string
Values are
multiply
,sum
,avg
,first
,max
, ormin
.
-
-
fuzzy object
Returns documents that contain terms similar to the search term, as measured by a Levenshtein edit distance.
-
geo_bounding_box object
Hide geo_bounding_box attributes Show geo_bounding_box attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
type string
Values are
memory
orindexed
. -
validation_method string
Values are
coerce
,ignore_malformed
, orstrict
. -
ignore_unmapped boolean
Set to
true
to ignore an unmapped field and not match any documents for this query. Set tofalse
to throw an exception if the field is not mapped.
-
-
geo_distance object
Hide geo_distance attributes Show geo_distance attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
distance_type string
Values are
arc
orplane
. -
validation_method string
Values are
coerce
,ignore_malformed
, orstrict
. -
ignore_unmapped boolean
Set to
true
to ignore an unmapped field and not match any documents for this query. Set tofalse
to throw an exception if the field is not mapped.
-
-
geo_polygon object
Hide geo_polygon attributes Show geo_polygon attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
validation_method string
Values are
coerce
,ignore_malformed
, orstrict
. -
ignore_unmapped boolean
-
-
geo_shape object
Hide geo_shape attributes Show geo_shape attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
ignore_unmapped boolean
Set to
true
to ignore an unmapped field and not match any documents for this query. Set tofalse
to throw an exception if the field is not mapped.
-
-
has_child object
Hide has_child attributes Show has_child attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
ignore_unmapped boolean
Indicates whether to ignore an unmapped
type
and not return any documents instead of an error. -
inner_hits object
Hide inner_hits attributes Show inner_hits attributes
-
name string
-
size number
The maximum number of hits to return per
inner_hits
. -
from number
Inner hit starting document offset.
-
collapse object
Hide collapse attributes Show collapse attributes
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
inner_hits object | array[object]
The number of inner hits and their sort order
-
The number of concurrent requests allowed to retrieve the inner_hits per group
-
collapse object
-
-
docvalue_fields array[object]
Hide docvalue_fields attributes Show docvalue_fields attributes object
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
format string
Format in which the values are returned.
-
include_unmapped boolean
-
-
explain boolean
-
highlight object
Hide highlight attributes Show highlight attributes
-
boundary_chars string
A string that contains each boundary character.
-
boundary_max_scan number
How far to scan for boundary characters.
-
boundary_scanner string
Values are
chars
,sentence
, orword
. -
boundary_scanner_locale string
Controls which locale is used to search for sentence and word boundaries. This parameter takes a form of a language tag, for example:
"en-US"
,"fr-FR"
,"ja-JP"
. -
fragmenter string
Values are
simple
orspan
. -
fragment_size number
The size of the highlighted fragment in characters.
-
highlight_filter boolean
-
highlight_query object
-
max_fragment_length number
-
max_analyzed_offset number
If set to a non-negative value, highlighting stops at this defined maximum limit. The rest of the text is not processed, thus not highlighted and no error is returned The
max_analyzed_offset
query setting does not override theindex.highlight.max_analyzed_offset
setting, which prevails when it’s set to lower value than the query setting. -
no_match_size number
The amount of text you want to return from the beginning of the field if there are no matching fragments to highlight.
-
number_of_fragments number
The maximum number of fragments to return. If the number of fragments is set to
0
, no fragments are returned. Instead, the entire field contents are highlighted and returned. This can be handy when you need to highlight short texts such as a title or address, but fragmentation is not required. Ifnumber_of_fragments
is0
,fragment_size
is ignored. -
options object
-
order string
Value is
score
. -
phrase_limit number
Controls the number of matching phrases in a document that are considered. Prevents the
fvh
highlighter from analyzing too many phrases and consuming too much memory. When usingmatched_fields
,phrase_limit
phrases per matched field are considered. Raising the limit increases query time and consumes more memory. Only supported by thefvh
highlighter. -
post_tags array[string]
Use in conjunction with
pre_tags
to define the HTML tags to use for the highlighted text. By default, highlighted text is wrapped in<em>
and</em>
tags. -
pre_tags array[string]
Use in conjunction with
post_tags
to define the HTML tags to use for the highlighted text. By default, highlighted text is wrapped in<em>
and</em>
tags. -
require_field_match boolean
By default, only fields that contains a query match are highlighted. Set to
false
to highlight all fields. -
tags_schema string
Value is
styled
. -
encoder string
Values are
default
orhtml
.
-
ignore_unmapped boolean
-
script_fields object
Hide script_fields attributes Show script_fields attributes
-
ignore_failure boolean
-
seq_no_primary_term boolean
-
fields string | array[string]
-
stored_fields string | array[string]
-
track_scores boolean
-
version boolean
-
-
max_children number
Maximum number of child documents that match the query allowed for a returned parent document. If the parent document exceeds this limit, it is excluded from the search results.
-
min_children number
Minimum number of child documents that match the query required to match the query for a returned parent document. If the parent document does not meet this limit, it is excluded from the search results.
-
score_mode string
Values are
none
,avg
,sum
,max
, ormin
.
-
-
has_parent object
Hide has_parent attributes Show has_parent attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
ignore_unmapped boolean
Indicates whether to ignore an unmapped
parent_type
and not return any documents instead of an error. You can use this parameter to query multiple indices that may not contain theparent_type
. -
inner_hits object
Hide inner_hits attributes Show inner_hits attributes
-
name string
-
size number
The maximum number of hits to return per
inner_hits
. -
from number
Inner hit starting document offset.
-
collapse object
Hide collapse attributes Show collapse attributes
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
inner_hits object | array[object]
The number of inner hits and their sort order
-
The number of concurrent requests allowed to retrieve the inner_hits per group
-
collapse object
-
-
docvalue_fields array[object]
Hide docvalue_fields attributes Show docvalue_fields attributes object
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
format string
Format in which the values are returned.
-
include_unmapped boolean
-
-
explain boolean
-
highlight object
Hide highlight attributes Show highlight attributes
-
boundary_chars string
A string that contains each boundary character.
-
boundary_max_scan number
How far to scan for boundary characters.
-
boundary_scanner string
Values are
chars
,sentence
, orword
. -
boundary_scanner_locale string
Controls which locale is used to search for sentence and word boundaries. This parameter takes a form of a language tag, for example:
"en-US"
,"fr-FR"
,"ja-JP"
. -
fragmenter string
Values are
simple
orspan
. -
fragment_size number
The size of the highlighted fragment in characters.
-
highlight_filter boolean
-
highlight_query object
-
max_fragment_length number
-
max_analyzed_offset number
If set to a non-negative value, highlighting stops at this defined maximum limit. The rest of the text is not processed, thus not highlighted and no error is returned The
max_analyzed_offset
query setting does not override theindex.highlight.max_analyzed_offset
setting, which prevails when it’s set to lower value than the query setting. -
no_match_size number
The amount of text you want to return from the beginning of the field if there are no matching fragments to highlight.
-
number_of_fragments number
The maximum number of fragments to return. If the number of fragments is set to
0
, no fragments are returned. Instead, the entire field contents are highlighted and returned. This can be handy when you need to highlight short texts such as a title or address, but fragmentation is not required. Ifnumber_of_fragments
is0
,fragment_size
is ignored. -
options object
-
order string
Value is
score
. -
phrase_limit number
Controls the number of matching phrases in a document that are considered. Prevents the
fvh
highlighter from analyzing too many phrases and consuming too much memory. When usingmatched_fields
,phrase_limit
phrases per matched field are considered. Raising the limit increases query time and consumes more memory. Only supported by thefvh
highlighter. -
post_tags array[string]
Use in conjunction with
pre_tags
to define the HTML tags to use for the highlighted text. By default, highlighted text is wrapped in<em>
and</em>
tags. -
pre_tags array[string]
Use in conjunction with
post_tags
to define the HTML tags to use for the highlighted text. By default, highlighted text is wrapped in<em>
and</em>
tags. -
require_field_match boolean
By default, only fields that contains a query match are highlighted. Set to
false
to highlight all fields. -
tags_schema string
Value is
styled
. -
encoder string
Values are
default
orhtml
.
-
ignore_unmapped boolean
-
script_fields object
Hide script_fields attributes Show script_fields attributes
-
ignore_failure boolean
-
seq_no_primary_term boolean
-
fields string | array[string]
-
stored_fields string | array[string]
-
track_scores boolean
-
version boolean
-
-
score boolean
Indicates whether the relevance score of a matching parent document is aggregated into its child documents.
-
-
ids object
Hide ids attributes Show ids attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
values string | array[string]
-
-
intervals object
Returns documents based on the order and proximity of matching terms.
-
knn object
Hide knn attributes Show knn attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
query_vector array[number]
-
query_vector_builder object
Hide query_vector_builder attribute Show query_vector_builder attribute
-
text_embedding object
Hide text_embedding attributes Show text_embedding attributes
-
-
num_candidates number
The number of nearest neighbor candidates to consider per shard
-
k number
The final number of nearest neighbors to return as top hits
filter object | array[object]
Filters for the kNN search query
-
similarity number
The minimum similarity for a vector to be considered a match
-
-
match object
Returns documents that match a provided text, number, date or boolean value. The provided text is analyzed before matching.
-
match_all object
Hide match_all attributes Show match_all attributes
-
match_bool_prefix object
Analyzes its input and constructs a
bool
query from the terms. Each term except the last is used in aterm
query. The last term is used in a prefix query. -
match_none object
Hide match_none attributes Show match_none attributes
-
match_phrase object
Analyzes the text and creates a phrase query out of the analyzed text.
-
match_phrase_prefix object
Returns documents that contain the words of a provided text, in the same order as provided. The last term of the provided text is treated as a prefix, matching any words that begin with that term.
-
more_like_this object
Hide more_like_this attributes Show more_like_this attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
analyzer string
The analyzer that is used to analyze the free form text. Defaults to the analyzer associated with the first field in fields.
-
boost_terms number
Each term in the formed query could be further boosted by their tf-idf score. This sets the boost factor to use when using this feature. Defaults to deactivated (0).
-
fail_on_unsupported_field boolean
Controls whether the query should fail (throw an exception) if any of the specified fields are not of the supported types (
text
orkeyword
). -
fields array[string]
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
include boolean
Specifies whether the input documents should also be included in the search results returned.
like string | object | array[string | object]
Specifies free form text and/or a single or multiple documents for which you want to find similar documents.
One of: Hide attributes Show attributes
-
doc object
A document not present in the index.
-
fields array[string]
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
_id string
-
_index string
-
per_field_analyzer object
Overrides the default analyzer.
-
routing string
-
version number
-
version_type string
Values are
internal
,external
,external_gte
, orforce
.
Text that we want similar documents for or a lookup to a document's field for the text.
-
-
max_doc_freq number
The maximum document frequency above which the terms are ignored from the input document.
-
max_query_terms number
The maximum number of query terms that can be selected.
-
max_word_length number
The maximum word length above which the terms are ignored. Defaults to unbounded (
0
). -
min_doc_freq number
The minimum document frequency below which the terms are ignored from the input document.
minimum_should_match number | string
The minimum number of terms that should match as integer, percentage or range
-
min_term_freq number
The minimum term frequency below which the terms are ignored from the input document.
-
min_word_length number
The minimum word length below which the terms are ignored.
-
routing string
stop_words string | array[string]
Language value, such as arabic or thai. Defaults to english. Each language value corresponds to a predefined list of stop words in Lucene. See Stop words by language for supported language values and their stop words. Also accepts an array of stop words.
unlike string | object | array[string | object]
Used in combination with
like
to exclude documents that match a set of terms.One of: Hide attributes Show attributes
-
doc object
A document not present in the index.
-
fields array[string]
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
_id string
-
_index string
-
per_field_analyzer object
Overrides the default analyzer.
-
routing string
-
version number
-
version_type string
Values are
internal
,external
,external_gte
, orforce
.
Text that we want similar documents for or a lookup to a document's field for the text.
-
-
version number
-
version_type string
Values are
internal
,external
,external_gte
, orforce
.
-
-
multi_match object
Hide multi_match attributes Show multi_match attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
analyzer string
Analyzer used to convert the text in the query value into tokens.
-
If
true
, match phrase queries are automatically created for multi-term synonyms. -
fields string | array[string]
fuzziness string | number
-
fuzzy_rewrite string
-
fuzzy_transpositions boolean
If
true
, edits for fuzzy matching include transpositions of two adjacent characters (for example,ab
toba
). Can be applied to the term subqueries constructed for all terms but the final term. -
lenient boolean
If
true
, format-based errors, such as providing a text query value for a numeric field, are ignored. -
max_expansions number
Maximum number of terms to which the query will expand.
minimum_should_match number | string
The minimum number of terms that should match as integer, percentage or range
-
operator string
Values are
and
,AND
,or
, orOR
. -
prefix_length number
Number of beginning characters left unchanged for fuzzy matching.
-
Text, number, boolean value or date you wish to find in the provided field.
-
slop number
Maximum number of positions allowed between matching tokens.
-
tie_breaker number
Determines how scores for each per-term blended query and scores across groups are combined.
-
type string
Values are
best_fields
,most_fields
,cross_fields
,phrase
,phrase_prefix
, orbool_prefix
. -
zero_terms_query string
Values are
all
ornone
.
-
-
nested object
Hide nested attributes Show nested attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
ignore_unmapped boolean
Indicates whether to ignore an unmapped path and not return any documents instead of an error.
-
inner_hits object
Hide inner_hits attributes Show inner_hits attributes
-
name string
-
size number
The maximum number of hits to return per
inner_hits
. -
from number
Inner hit starting document offset.
-
collapse object
Hide collapse attributes Show collapse attributes
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
inner_hits object | array[object]
The number of inner hits and their sort order
-
The number of concurrent requests allowed to retrieve the inner_hits per group
-
collapse object
-
-
docvalue_fields array[object]
Hide docvalue_fields attributes Show docvalue_fields attributes object
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
format string
Format in which the values are returned.
-
include_unmapped boolean
-
-
explain boolean
-
highlight object
Hide highlight attributes Show highlight attributes
-
boundary_chars string
A string that contains each boundary character.
-
boundary_max_scan number
How far to scan for boundary characters.
-
boundary_scanner string
Values are
chars
,sentence
, orword
. -
boundary_scanner_locale string
Controls which locale is used to search for sentence and word boundaries. This parameter takes a form of a language tag, for example:
"en-US"
,"fr-FR"
,"ja-JP"
. -
fragmenter string
Values are
simple
orspan
. -
fragment_size number
The size of the highlighted fragment in characters.
-
highlight_filter boolean
-
highlight_query object
-
max_fragment_length number
-
max_analyzed_offset number
If set to a non-negative value, highlighting stops at this defined maximum limit. The rest of the text is not processed, thus not highlighted and no error is returned The
max_analyzed_offset
query setting does not override theindex.highlight.max_analyzed_offset
setting, which prevails when it’s set to lower value than the query setting. -
no_match_size number
The amount of text you want to return from the beginning of the field if there are no matching fragments to highlight.
-
number_of_fragments number
The maximum number of fragments to return. If the number of fragments is set to
0
, no fragments are returned. Instead, the entire field contents are highlighted and returned. This can be handy when you need to highlight short texts such as a title or address, but fragmentation is not required. Ifnumber_of_fragments
is0
,fragment_size
is ignored. -
options object
-
order string
Value is
score
. -
phrase_limit number
Controls the number of matching phrases in a document that are considered. Prevents the
fvh
highlighter from analyzing too many phrases and consuming too much memory. When usingmatched_fields
,phrase_limit
phrases per matched field are considered. Raising the limit increases query time and consumes more memory. Only supported by thefvh
highlighter. -
post_tags array[string]
Use in conjunction with
pre_tags
to define the HTML tags to use for the highlighted text. By default, highlighted text is wrapped in<em>
and</em>
tags. -
pre_tags array[string]
Use in conjunction with
post_tags
to define the HTML tags to use for the highlighted text. By default, highlighted text is wrapped in<em>
and</em>
tags. -
require_field_match boolean
By default, only fields that contains a query match are highlighted. Set to
false
to highlight all fields. -
tags_schema string
Value is
styled
. -
encoder string
Values are
default
orhtml
.
-
ignore_unmapped boolean
-
script_fields object
Hide script_fields attributes Show script_fields attributes
-
ignore_failure boolean
-
seq_no_primary_term boolean
-
fields string | array[string]
-
stored_fields string | array[string]
-
track_scores boolean
-
version boolean
-
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
score_mode string
Values are
none
,avg
,sum
,max
, ormin
.
-
-
parent_id object
Hide parent_id attributes Show parent_id attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
id string
-
ignore_unmapped boolean
Indicates whether to ignore an unmapped
type
and not return any documents instead of an error. -
type string
-
-
percolate object
Hide percolate attributes Show percolate attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
document object
The source of the document being percolated.
-
documents array[object]
An array of sources of the documents being percolated.
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
id string
-
index string
-
name string
The suffix used for the
_percolator_document_slot
field when multiplepercolate
queries are specified. -
preference string
Preference used to fetch document to percolate.
-
routing string
-
version number
-
-
pinned object
Hide pinned attributes Show pinned attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
ids array[string]
Document IDs listed in the order they are to appear in results. Required if
docs
is not specified. -
docs array[object]
Documents listed in the order they are to appear in results. Required if
ids
is not specified.
-
-
prefix object
Returns documents that contain a specific prefix in a provided field.
-
query_string object
Hide query_string attributes Show query_string attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
allow_leading_wildcard boolean
If
true
, the wildcard characters*
and?
are allowed as the first character of the query string. -
analyzer string
Analyzer used to convert text in the query string into tokens.
-
analyze_wildcard boolean
If
true
, the query attempts to analyze wildcard terms in the query string. -
If
true
, match phrase queries are automatically created for multi-term synonyms. -
default_field string
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
default_operator string
Values are
and
,AND
,or
, orOR
. -
enable_position_increments boolean
If
true
, enable position increments in queries constructed from aquery_string
search. -
escape boolean
-
fields array[string]
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
fuzziness string | number
-
fuzzy_max_expansions number
Maximum number of terms to which the query expands for fuzzy matching.
-
fuzzy_prefix_length number
Number of beginning characters left unchanged for fuzzy matching.
-
fuzzy_rewrite string
-
fuzzy_transpositions boolean
If
true
, edits for fuzzy matching include transpositions of two adjacent characters (for example,ab
toba
). -
lenient boolean
If
true
, format-based errors, such as providing a text value for a numeric field, are ignored. -
max_determinized_states number
Maximum number of automaton states required for the query.
minimum_should_match number | string
The minimum number of terms that should match as integer, percentage or range
-
phrase_slop number
Maximum number of positions allowed between matching tokens for phrases.
-
Query string you wish to parse and use for search.
-
quote_analyzer string
Analyzer used to convert quoted text in the query string into tokens. For quoted text, this parameter overrides the analyzer specified in the
analyzer
parameter. -
quote_field_suffix string
Suffix appended to quoted text in the query string. You can use this suffix to use a different analysis method for exact matches.
-
rewrite string
-
tie_breaker number
How to combine the queries generated from the individual search terms in the resulting
dis_max
query. -
time_zone string
-
type string
Values are
best_fields
,most_fields
,cross_fields
,phrase
,phrase_prefix
, orbool_prefix
.
-
-
range object
Returns documents that contain terms within a provided range.
-
rank_feature object
Hide rank_feature attributes Show rank_feature attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
saturation object
Hide saturation attribute Show saturation attribute
-
pivot number
Configurable pivot value so that the result will be less than 0.5.
-
-
log object
Hide log attribute Show log attribute
-
Configurable scaling factor.
-
-
linear object
-
sigmoid object
-
-
regexp object
Returns documents that contain terms matching a regular expression.
-
rule object
Hide rule attributes Show rule attributes
-
script object
Hide script attributes Show script attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Hide script attributes Show script attributes
-
source string
The script source.
-
id string
-
params object
Specifies any named parameters that are passed into the script as variables. Use parameters instead of hard-coded values to decrease compile time.
Hide params attributes Show params attributes
-
key object
-
options object
Hide options attributes Show options attributes
-
key string
-
-
-
script_score object
Hide script_score attributes Show script_score attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
min_score number
Documents with a score lower than this floating point number are excluded from the search results.
-
Hide script attributes Show script attributes
-
source string
The script source.
-
id string
-
params object
Specifies any named parameters that are passed into the script as variables. Use parameters instead of hard-coded values to decrease compile time.
Hide params attributes Show params attributes
-
key object
-
options object
Hide options attributes Show options attributes
-
key string
-
-
-
semantic object
Hide semantic attributes Show semantic attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
The field to query, which must be a semantic_text field type
-
The query text
-
-
shape object
Hide shape attributes Show shape attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
ignore_unmapped boolean
When set to
true
the query ignores an unmapped field and will not match any documents.
-
-
simple_query_string object
Hide simple_query_string attributes Show simple_query_string attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
analyzer string
Analyzer used to convert text in the query string into tokens.
-
analyze_wildcard boolean
If
true
, the query attempts to analyze wildcard terms in the query string. -
If
true
, the parser creates a match_phrase query for each multi-position token. -
default_operator string
Values are
and
,AND
,or
, orOR
. -
fields array[string]
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
flags string
Query flags can be either a single flag or a combination of flags, e.g.
OR|AND|PREFIX
One of: Query flags can be either a single flag or a combination of flags, e.g.
OR|AND|PREFIX
Values are
NONE
,AND
,NOT
,OR
,PREFIX
,PHRASE
,PRECEDENCE
,ESCAPE
,WHITESPACE
,FUZZY
,NEAR
,SLOP
, orALL
.Query flags can be either a single flag or a combination of flags, e.g.
OR|AND|PREFIX
-
fuzzy_max_expansions number
Maximum number of terms to which the query expands for fuzzy matching.
-
fuzzy_prefix_length number
Number of beginning characters left unchanged for fuzzy matching.
-
fuzzy_transpositions boolean
If
true
, edits for fuzzy matching include transpositions of two adjacent characters (for example,ab
toba
). -
lenient boolean
If
true
, format-based errors, such as providing a text value for a numeric field, are ignored. minimum_should_match number | string
The minimum number of terms that should match as integer, percentage or range
-
Query string in the simple query string syntax you wish to parse and use for search.
-
quote_field_suffix string
Suffix appended to quoted text in the query string.
-
-
span_containing object
Hide span_containing attributes Show span_containing attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Hide big attributes Show big attributes
-
span_field_masking object
Hide span_field_masking attributes Show span_field_masking attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
-
span_first object
Hide span_first attributes Show span_first attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Controls the maximum end position permitted in a match.
-
-
span_gap object
Can only be used as a clause in a span_near query.
Hide span_gap attributes Show span_gap attributes
-
key number
-
span_multi object
Hide span_multi attributes Show span_multi attributes
-
span_near object
Hide span_near attributes Show span_near attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
in_order boolean
Controls whether matches are required to be in-order.
-
slop number
Controls the maximum number of intervening unmatched positions permitted.
-
-
span_not object
Hide span_not attributes Show span_not attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
dist number
The number of tokens from within the include span that can’t have overlap with the exclude span. Equivalent to setting both
pre
andpost
. -
post number
The number of tokens after the include span that can’t have overlap with the exclude span.
-
pre number
The number of tokens before the include span that can’t have overlap with the exclude span.
-
-
span_or object
Hide span_or attributes Show span_or attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
-
span_term object
The equivalent of the
term
query but for use with other span queries. -
span_within object
Hide span_within attributes Show span_within attributes
-
Hide little attributes Show little attributes
-
span_field_masking object
Hide span_field_masking attributes Show span_field_masking attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
-
span_first object
Hide span_first attributes Show span_first attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Controls the maximum end position permitted in a match.
-
-
span_gap object
Can only be used as a clause in a span_near query.
Hide span_gap attributes Show span_gap attributes
-
key number
-
span_multi object
Hide span_multi attributes Show span_multi attributes
-
span_near object
Hide span_near attributes Show span_near attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
in_order boolean
Controls whether matches are required to be in-order.
-
slop number
Controls the maximum number of intervening unmatched positions permitted.
-
-
span_not object
Hide span_not attributes Show span_not attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
dist number
The number of tokens from within the include span that can’t have overlap with the exclude span. Equivalent to setting both
pre
andpost
. -
post number
The number of tokens after the include span that can’t have overlap with the exclude span.
-
pre number
The number of tokens before the include span that can’t have overlap with the exclude span.
-
-
span_or object
Hide span_or attributes Show span_or attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
-
span_term object
The equivalent of the
term
query but for use with other span queries. -
span_within object
Hide span_within attributes Show span_within attributes
-
-
span_field_masking object
Hide span_field_masking attributes Show span_field_masking attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
Hide query attributes Show query attributes
-
span_containing object
Hide span_containing attributes Show span_containing attributes
-
span_first object
Hide span_first attributes Show span_first attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Controls the maximum end position permitted in a match.
-
-
span_gap object
Can only be used as a clause in a span_near query.
Hide span_gap attributes Show span_gap attributes
-
key number
-
span_multi object
Hide span_multi attributes Show span_multi attributes
-
span_near object
Hide span_near attributes Show span_near attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
in_order boolean
Controls whether matches are required to be in-order.
-
slop number
Controls the maximum number of intervening unmatched positions permitted.
-
-
span_not object
Hide span_not attributes Show span_not attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
dist number
The number of tokens from within the include span that can’t have overlap with the exclude span. Equivalent to setting both
pre
andpost
. -
post number
The number of tokens after the include span that can’t have overlap with the exclude span.
-
pre number
The number of tokens before the include span that can’t have overlap with the exclude span.
-
-
span_or object
Hide span_or attributes Show span_or attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
-
span_term object
The equivalent of the
term
query but for use with other span queries. -
span_within object
Hide span_within attributes Show span_within attributes
-
-
-
span_first object
Hide span_first attributes Show span_first attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Controls the maximum end position permitted in a match.
-
Hide match attributes Show match attributes
-
span_containing object
Hide span_containing attributes Show span_containing attributes
-
span_field_masking object
Hide span_field_masking attributes Show span_field_masking attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
-
span_gap object
Can only be used as a clause in a span_near query.
Hide span_gap attributes Show span_gap attributes
-
key number
-
span_multi object
Hide span_multi attributes Show span_multi attributes
-
span_near object
Hide span_near attributes Show span_near attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
in_order boolean
Controls whether matches are required to be in-order.
-
slop number
Controls the maximum number of intervening unmatched positions permitted.
-
-
span_not object
Hide span_not attributes Show span_not attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
dist number
The number of tokens from within the include span that can’t have overlap with the exclude span. Equivalent to setting both
pre
andpost
. -
post number
The number of tokens after the include span that can’t have overlap with the exclude span.
-
pre number
The number of tokens before the include span that can’t have overlap with the exclude span.
-
-
span_or object
Hide span_or attributes Show span_or attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
-
span_term object
The equivalent of the
term
query but for use with other span queries. -
span_within object
Hide span_within attributes Show span_within attributes
-
-
-
span_multi object
Hide span_multi attributes Show span_multi attributes
-
span_near object
Hide span_near attributes Show span_near attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
Hide clauses attributes Show clauses attributes object
-
span_containing object
-
span_field_masking object
-
span_first object
-
span_gap object
Can only be used as a clause in a span_near query.
Hide span_gap attributes Show span_gap attributes
-
key number
-
span_multi object
-
span_not object
-
span_or object
-
span_term object
The equivalent of the
term
query but for use with other span queries. -
span_within object
-
-
in_order boolean
Controls whether matches are required to be in-order.
-
slop number
Controls the maximum number of intervening unmatched positions permitted.
-
-
span_not object
Hide span_not attributes Show span_not attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
dist number
The number of tokens from within the include span that can’t have overlap with the exclude span. Equivalent to setting both
pre
andpost
. -
Hide exclude attributes Show exclude attributes
-
span_containing object
Hide span_containing attributes Show span_containing attributes
-
span_field_masking object
Hide span_field_masking attributes Show span_field_masking attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
-
span_first object
Hide span_first attributes Show span_first attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Controls the maximum end position permitted in a match.
-
-
span_gap object
Can only be used as a clause in a span_near query.
Hide span_gap attributes Show span_gap attributes
-
key number
-
span_multi object
Hide span_multi attributes Show span_multi attributes
-
span_near object
Hide span_near attributes Show span_near attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
in_order boolean
Controls whether matches are required to be in-order.
-
slop number
Controls the maximum number of intervening unmatched positions permitted.
-
-
span_or object
Hide span_or attributes Show span_or attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
-
span_term object
The equivalent of the
term
query but for use with other span queries. -
span_within object
Hide span_within attributes Show span_within attributes
-
-
Hide include attributes Show include attributes
-
span_containing object
Hide span_containing attributes Show span_containing attributes
-
span_field_masking object
Hide span_field_masking attributes Show span_field_masking attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
-
span_first object
Hide span_first attributes Show span_first attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Controls the maximum end position permitted in a match.
-
-
span_gap object
Can only be used as a clause in a span_near query.
Hide span_gap attributes Show span_gap attributes
-
key number
-
span_multi object
Hide span_multi attributes Show span_multi attributes
-
span_near object
Hide span_near attributes Show span_near attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
in_order boolean
Controls whether matches are required to be in-order.
-
slop number
Controls the maximum number of intervening unmatched positions permitted.
-
-
span_or object
Hide span_or attributes Show span_or attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
-
span_term object
The equivalent of the
term
query but for use with other span queries. -
span_within object
Hide span_within attributes Show span_within attributes
-
-
post number
The number of tokens after the include span that can’t have overlap with the exclude span.
-
pre number
The number of tokens before the include span that can’t have overlap with the exclude span.
-
-
span_or object
Hide span_or attributes Show span_or attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
Hide clauses attributes Show clauses attributes object
-
span_containing object
-
span_field_masking object
-
span_first object
-
span_gap object
Can only be used as a clause in a span_near query.
Hide span_gap attributes Show span_gap attributes
-
key number
-
span_multi object
-
span_near object
-
span_not object
-
span_term object
The equivalent of the
term
query but for use with other span queries. -
span_within object
-
-
-
span_term object
Matches spans containing a term.
-
span_within object
Hide span_within attributes Show span_within attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Hide big attributes Show big attributes
-
span_containing object
Hide span_containing attributes Show span_containing attributes
-
span_field_masking object
Hide span_field_masking attributes Show span_field_masking attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
-
span_first object
Hide span_first attributes Show span_first attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Controls the maximum end position permitted in a match.
-
-
span_gap object
Can only be used as a clause in a span_near query.
Hide span_gap attributes Show span_gap attributes
-
key number
-
span_multi object
Hide span_multi attributes Show span_multi attributes
-
span_near object
Hide span_near attributes Show span_near attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
in_order boolean
Controls whether matches are required to be in-order.
-
slop number
Controls the maximum number of intervening unmatched positions permitted.
-
-
span_not object
Hide span_not attributes Show span_not attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
dist number
The number of tokens from within the include span that can’t have overlap with the exclude span. Equivalent to setting both
pre
andpost
. -
post number
The number of tokens after the include span that can’t have overlap with the exclude span.
-
pre number
The number of tokens before the include span that can’t have overlap with the exclude span.
-
-
span_or object
Hide span_or attributes Show span_or attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
-
span_term object
The equivalent of the
term
query but for use with other span queries.
-
-
Hide little attributes Show little attributes
-
span_containing object
Hide span_containing attributes Show span_containing attributes
-
span_field_masking object
Hide span_field_masking attributes Show span_field_masking attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
-
span_first object
Hide span_first attributes Show span_first attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Controls the maximum end position permitted in a match.
-
-
span_gap object
Can only be used as a clause in a span_near query.
Hide span_gap attributes Show span_gap attributes
-
key number
-
span_multi object
Hide span_multi attributes Show span_multi attributes
-
span_near object
Hide span_near attributes Show span_near attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
in_order boolean
Controls whether matches are required to be in-order.
-
slop number
Controls the maximum number of intervening unmatched positions permitted.
-
-
span_not object
Hide span_not attributes Show span_not attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
dist number
The number of tokens from within the include span that can’t have overlap with the exclude span. Equivalent to setting both
pre
andpost
. -
post number
The number of tokens after the include span that can’t have overlap with the exclude span.
-
pre number
The number of tokens before the include span that can’t have overlap with the exclude span.
-
-
span_or object
Hide span_or attributes Show span_or attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Array of one or more other span type queries.
-
-
span_term object
The equivalent of the
term
query but for use with other span queries.
-
-
-
sparse_vector object
Hide sparse_vector attributes Show sparse_vector attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
-
query string
The query text you want to use for search. If inference_id is specified, query must also be specified.
-
prune boolean
Whether to perform pruning, omitting the non-significant tokens from the query to improve query performance. If prune is true but the pruning_config is not specified, pruning will occur but default values will be used. Default: false
-
pruning_config object
Hide pruning_config attributes Show pruning_config attributes
-
tokens_freq_ratio_threshold number
Tokens whose frequency is more than this threshold times the average frequency of all tokens in the specified field are considered outliers and pruned.
-
tokens_weight_threshold number
Tokens whose weight is less than this threshold are considered nonsignificant and pruned.
-
only_score_pruned_tokens boolean
Whether to only score pruned tokens, vs only scoring kept tokens.
-
-
query_vector object
Dictionary of precomputed sparse vectors and their associated weights. Only one of inference_id or query_vector may be supplied in a request.
Hide query_vector attributes Show query_vector attributes
-
key number
-
inference_id string
-
-
term object
Returns documents that contain an exact term in a provided field. To return a document, the query term must exactly match the queried field's value, including whitespace and capitalization.
-
terms object
Hide terms attributes Show terms attributes
-
terms_set object
Returns documents that contain a minimum number of exact terms in a provided field. To return a document, a required number of terms must exactly match the field values, including whitespace and capitalization.
-
Uses a natural language processing model to convert the query text into a list of token-weight pairs which are then used in a query against a sparse vector or rank features field.
-
Supports returning text_expansion query results by sending in precomputed tokens with the query.
-
wildcard object
Returns documents that contain terms matching a wildcard pattern.
-
wrapper object
Hide wrapper attributes Show wrapper attributes
-
boost number
Floating point number used to decrease or increase the relevance scores of the query. Boost values are relative to the default value of 1.0. A boost value between 0 and 1.0 decreases the relevance score. A value greater than 1.0 increases the relevance score.
-
_name string
-
A base64 encoded query. The binary data format can be any of JSON, YAML, CBOR or SMILE encodings
-
-
type object
Hide type attributes Show type attributes
-
Responses
-
200 application/json
Hide response attributes Show response attributes object
-
explanations array[object]
Hide explanations attributes Show explanations attributes object
-
error string
-
explanation string
-
-
_shards object
Hide _shards attributes Show _shards attributes
-
failures array[object]
Hide failures attributes Show failures attributes object
-
index string
-
node string
-
Hide reason attributes Show reason attributes
-
The type of error
-
reason string
A human-readable explanation of the error, in english
-
stack_trace string
The server stack trace. Present only if the
error_trace=true
parameter was sent with the request. -
caused_by object
-
root_cause array[object]
-
suppressed array[object]
-
-
status string
-
-
skipped number
-
error string
-
curl \
-X GET http://api.example.com/_validate/query \
-H "Content-Type: application/json" \
-d '{"query":{"":{"boost":42.0,"_name":"string","value":"string"},"common":{},"fuzzy":{},"intervals":{},"match":{},"match_bool_prefix":{},"match_phrase":{},"match_phrase_prefix":{},"prefix":{},"range":{},"regexp":{},"span_term":{},"term":{},"terms_set":{},"text_expansion":{},"weighted_tokens":{},"wildcard":{}}}'