IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Boolean query Constant score query »
Elastic Docs ›Elasticsearch Guide [8.15] ›Query DSL ›Compound queries

Boosting query

edit

Boosting query

edit

Returns 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

edit
resp = 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, the boosting query calculates the final relevance score for the document as follows:

  1. Take the original relevance score from the positive query.
  2. Multiply the score by the negative_boost value.
negative_boost
(Required, float) Floating point number between 0 and 1.0 used to decrease the relevance scores of documents matching the negative query.
« Boolean query Constant score query »