This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.
Boosting query
editBoosting query
editReturns documents matching a positive
query while reducing the
relevance score of documents that also match a
negative
query.
You can use the boosting
query to demote certain documents without
excluding them from the search results.
Example request
editresp = client.search( query={ "boosting": { "positive": { "term": { "text": "apple" } }, "negative": { "term": { "text": "pie tart fruit crumble tree" } }, "negative_boost": 0.5 } }, ) print(resp)
response = client.search( body: { query: { boosting: { positive: { term: { text: 'apple' } }, negative: { term: { text: 'pie tart fruit crumble tree' } }, negative_boost: 0.5 } } } ) puts response
const response = await client.search({ query: { boosting: { positive: { term: { text: "apple", }, }, negative: { term: { text: "pie tart fruit crumble tree", }, }, negative_boost: 0.5, }, }, }); console.log(response);
GET /_search { "query": { "boosting": { "positive": { "term": { "text": "apple" } }, "negative": { "term": { "text": "pie tart fruit crumble tree" } }, "negative_boost": 0.5 } } }
Top-level parameters for boosting
edit-
positive
- (Required, query object) Query you wish to run. Any returned documents must match this query.
-
negative
-
(Required, query object) Query used to decrease the relevance score of matching documents.
If a returned document matches the
positive
query and this query, theboosting
query calculates the final relevance score for the document as follows:-
Take the original relevance score from the
positive
query. -
Multiply the score by the
negative_boost
value.
-
Take the original relevance score from the
-
negative_boost
-
(Required, float) Floating point number between
0
and1.0
used to decrease the relevance scores of documents matching thenegative
query.