🌟

This feature is powered by Loomi AI

Spell Correct and Did You Mean

A search request returns the autoCorrectQuery field when Bloomreach search intelligence automatically corrects your shopper's query. Spell Correct is triggered when the original query has 0 results and there's a query with similar text that does have results. You can display an indicator on the search results page when a query was spellcorrected.

You can also use the did_you_mean field to ask customers if they meant a different query from the one they entered. The did_you_mean field is similar to autoCorrectQuery, except it displays a list of other related queries (excluding the autoCorrectQuery result) rather than automatically changing the query.

📘

Spell Correct was formerly known as AutoCorrect

Sample Request and Response

GET http://core.dxpapi.com/api/v1/core/?
account_id=<Bloomreach Provided Account ID>
&auth_key=<Bloomreach Provided Authorization key>
&domain_key=homeoasis_com
&request_id=9824119820726
&_br_uid_2=uid%3D1356891981096%3Av%3D11.8%3Ats%3D1650345306243%3Ahc%3D142
&url=www.homeoasis.com
&ref_url=www.homeoasis.com
&request_type=search
&rows=10
&start=0
&fl=pid%2Ctitle%2Cbrand%2Cprice%2Csale_price%2Csku_color_group%2Curl%2Cprice_range
&q=paperrr
&search_type=keyword

The value of the spellcorrected query can be viewed under metadata.

"autoCorrectQuery": "paper", 
"metadata": { 
   "query": { 
      "modification": {
         "mode": "autoCorrectQuery", 
         "value": "paper"
       },
       "didyoumean": [
          "paper rr", 
          "papers", 
          "pa per rr"
      ]
   }
}

Spell Correct Algorithms

Spell Correct has the following two algorithms:

• Term Frequency
• Closest Match

Term Frequency (default mode)

This algorithm uses term frequency to rank the different candidates for a correction. In other words, the algorithm will consider a term that appears more frequently in your catalog as the likely candidate for spell correction.

For example, your customer enters the query "shrts". The list of corrected spellings can be "shirts", "shorts", and "shoes". Suppose the term “shorts” appears more frequently in your catalog than “shirts”, then the query “shrts” will get corrected to “shorts”.

In case of a tie, Edit Distance (the number of edits it takes to get from one term to another - in this case, between the user query and the spell-correct candidate) is used to select the spell-check candidate

Closest Match

This algorithm uses Edit Distance to select the Spell Correct suggestion. The Edit Distance between two sets of letters or numbers is the minimum number of edits it takes to get from one term to another.

The smaller the edit distance of a spell-correct candidate is to the original query, the higher it will rank. It helps determine which term is closest to what the user entered.

Consider the example in the table below:

"Shoes" will rank higher than "Shorts" since its Edit Distance is comparatively smaller. Hence, "Shoes" will be considered as the closest match for the given misspelled query.

Note: Clean data is important for selecting the closest match for the misspelled term.

The algorithm assumes that the product data provided is always correct. If your catalog contains spelling mistakes, the closest match algorithm may surface the incorrect terms. For instance, the query “orangic” can be autocorrected to “oragnic” instead of organic if your catalog has the misspelled term “oragnic”.

Spell Correct Algorithms Comparison

The following table can help you compare and understand how the above two modes prioritize candidates for autocorrecting the mistyped query:

Spell Correct algorithm enablement

You can easily enable either of these modes per your use case by:

• Passing a specified parameter directly to the front-end API call.
• Using Recall Studio to configure the modes.

However, if you want Bloomreach to configure this for you, please reach out to Support.