List of APIs
Search APIs
Search
Search Navigations
Null Search Terms
Search Term Performance
Search Products
Trending Searches
post

/recommendations/searches/similar

Customers on your website may be searching for a product line that you do not carry. In such a scenario, you can suggest alternative searches that would display the available products. GroupBy allows you to drive such searches by customer’s behavior, rather than having them curated by merchandisers.

The Similar Queries API helps find search queries similar to the customer’s search query. It not only considers how similar the queries look but also analyzes the meaning of the words in the query to find the best possible matches.

You can provide this experience on a null result landing page and power it by searches that return products.

Request Body

1 Example
Schema
object
customerArea
string

Production, staging, etc,

required
query
string

The search query.

required
sessionID
string

The Session ID of the user (from cookie)

required
visitorID
string

The Visitor ID of the user (from cookie)

required
loginID
string

The Login ID of the user (hash of unique identifier)

Responses

As a default, we suggest using the rank field to classify the quality of the suggestions. In the example above, “ribeyes” is a better suggestion than “steak”, which is a better suggestion than “bison steak”, and so on.

Alternatively, you can fine-tune our suggestions based on total searches, sequential searches, support, and conversion rate:

The total searches tells how many times the suggested query was searched for The sequential searches tells how many times a search happened on the original query, followed by a search on the suggested query The support is a ratio between the sequential and total searches The conversion rate tells how often the search query resulted in a purchase (conversion)

1 Example
Schema
object
status
object
result
object
serverTimestamp
string

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
$$.env
5 variables not set
customerid
area
query
visitorID
sessionID