Skip to main content
RichRelevance

find/autocomplete

Description

http://service.richrelevance.com/fin.../autocomplete/<API_KEY>

Returns a list of popular search terms that start with a prefix.

The response is a list of product search terms.  (See below for more details on the response object)

If there are no search terms starting with that prefix it will return a 200 response with an empty array.

Parameters

 

Name Data Type Required or Optional Description

query

String Required

The text to search auto complete suggestions for.

Example: query=shoes

lang

String Required

The language of the search.  Examples: "en", "fr", "jp".

start

Integer Required pagination parameter. Indicates start index of the result set.

rows

Integer Required pagination parameter. Indicates total number items to include in the result set

sessionId

String Optional

Identifies a single visit by a shopper.  Sessions are used by behavioral models (to scope user behavior in a shopping session) and reporting metrics.

Example: sessionId=93484

userId String Optional

User ID. A unique string to identify each shopper (user). All shopper behavior is stored using this key. It is case-sensitive, and should be the same user ID sent to RichRelevance in other applications.

Example: userId=0982347

channelId

String Optional

A channel is a description of the caller of this API.  It's mostly used to describe whether this API is being used in an Android app or a Call center app.

Example: ​channelId=CallCenter

log

Boolean Optional

If set to true this will log the search request event.  The default behavior is for this to be false.  In that case analytics and reporting are skipped.

region

String Optional Region Identifier
filter String Optional Used to specify search filters.

Example Request

http://service.richrelevance.com/find/v1/autocomplete/<API_KEY>?lang=en&query=max&log=true&userId=0982347&sessionId=93484&region=abc&channelId=CallCenter

Example Response

[{
"id":"maxi dress",
"terms":"maxi dress",
"type":"TOPTRENDS",
"value":"221"
},{
"id":"maxi",
"terms":"maxi",
"type":"TOPTRENDS",
"value":"77"
},{
"id":"maxi skirt",
"terms":"maxi skirt",
"type":"TOPTRENDS",
"value":"48"
},{
"id":"maxi dresses",
"terms":"maxi dresses",
"type":"TOPTRENDS",
"value":"46"
}]

 

Field Description
id Identifier for the auto complete suggestion
terms The auto complete word suggestion
type Type of the suggestion. Currently supported is "TOPTRENDS".
value Indicates popularity score of the suggestion