Boost

Execute a search query with filtering, exclusion, and result boosting against Elasticsearch indices.

This endpoint extends filter-and-sort by adding a boost array for soft relevance tuning. Boost filters act as SHOULD clauses — they increase the relevance score of matching documents without strictly filtering them out.

Filter Logic:

  • include array: must-match filters (AND logic), identical to Filter and Sort.
  • exclude array: must-not filters (NOT logic), identical to Filter and Sort.
  • boost array: SHOULD directives (OR logic) with configurable boost multipliers. A document can match zero or more boost filters; matching multiple boosts stacks their effects.

Boost Values:

  • 1.0 = no effect on score
  • > 1.0 = increase score (e.g., 2.0 doubles the relevance contribution)
  • < 1.0 = decrease score

Sorting Note: The boost endpoint does not support sort_by. Results are ordered by relevance score (highest first), which incorporates both the base Elasticsearch score and any boost multipliers.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
enum
required

The Elasticsearch index to search

Allowed:
integer
1 to 10000
Defaults to 100

Number of results to return

include
array of objects

Filters that must match (AND logic). Identical to Filter and Sort.

include
exclude
array of objects

Filters that must NOT match (NOT logic). Identical to Filter and Sort.

exclude
boost
array of objects

Filters that boost relevance scores (SHOULD directives with OR logic). Each filter must specify a boost value. Items matching these filters receive a score multiplier without being strictly filtered.

boost
boolean
Defaults to false

Return only document IDs without source data. Mutually exclusive with select_fields and include_vector.

select_fields
array of strings

Specific fields to return in results. Mutually exclusive with only_ids and include_vector.

select_fields
boolean
Defaults to false

Include vector embeddings in the response. Mutually exclusive with only_ids and select_fields.

Responses

Language
Credentials
Bearer
API Key
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json