search mobile facets autocomplete spellcheck crawler rankings weights synonyms analytics engage api customize documentation install setup technology content domains user history info home business cart chart contact email activate analyticsalt analytics autocomplete cart contact content crawling custom documentation domains email engage faceted history info install mobile person querybuilder search setup spellcheck synonyms weights engage_search_term engage_related_content engage_next_results engage_personalized_results engage_recent_results success add arrow-down arrow-left arrow-right arrow-up caret-down caret-left caret-right caret-up check close content conversions-small conversions details edit grid help small-info error live magento minus move photo pin plus preview refresh search settings small-home stat subtract text trash unpin wordpress x alert case_deflection advanced-permissions keyword-detection predictive-ai sso

Functional Boosts

Engine Type Supported?
Crawler-based Engine YES
API-based Engine YES

Functional boosts increase result scores based on the value of an integer or float field.

There are 3 types of functional boosts:

Boost Type Description
logarithmic Multiplies the original score by ln(field value)
exponential Multiplies the original score by efield value
linear Multiplies the original score by field value
q
required
The query used within your search.
engine_key
required
The Engine Key associated with your Engine. Found within your dashboard.
functional_boosts
optional
Values can be logarithmic, exponential, or linear. See the above table for more information.
Example - Return the most popular results from the books DocumentType, but first boost the total_purchases field with a logarithmic boost. Crawler based Engines use page as the default DocumentType.
curl -XGET 'https://search-api.swiftype.com/api/v1/public/engines/search.json' \
  -H 'Content-Type: application/json' \
  -d '{
        "engine_key": "YOUR_ENGINE_KEY",
        "q": "brothers",
        "functional_boosts":{
          "books":{
            "total_purchases":"logarithmic"
          }
        }
      }'

Supported Field Types

Type Boosting
string No
text No
enum No
integer Yes
float Yes
date No
location No

Stuck? Looking for help? Contact support or check out the Site Search community forum!