BloomreachAutosuggestGeneratedApiAutosuggestApiRequest
Request parameters for autosuggestApi operation in BloomreachAutosuggestGeneratedApi.
interface BloomreachAutosuggestGeneratedApiAutosuggestApiRequest {
readonly accountId: number;
readonly authKey?: string;
readonly brUid2: string;
readonly callback?: AutosuggestApiCallbackEnum;
readonly catalogViews: string;
readonly q: string;
readonly refUrl: string;
readonly requestId: string;
readonly requestType: AutosuggestApiRequestTypeEnum;
readonly url: string;
readonly userAgent?: string;
readonly userId?: string;
}Properties
| Name | Required | Type | Description |
|---|---|---|---|
accountId | Required | number | Your site's numerical Bloomreach account ID. Your Bloomreach representative gives your site's account ID to you before or during your integration kickoff meeting. <br><br> The example value shown here, <i>6413</i>, is included for your convenience to send a request with <b>Try It</b>. |
authKey | Optional | string | The authentication key provided by Bloomreach for the account that's sending the request. <br><br> Autosuggest API calls are client-side, so you can leave auth_key empty. |
brUid2 | Required | string | A first-party cookie created by the Bloomreach tracking pixel library (BrTrk). This cookie creates a unique, anonymous identifier for every browser or device. <br><br> Use the default value provided, which is already encoded. |
callback | Optional | AutosuggestApiCallbackEnum | Indicates whether to return data wrapped in the function for cross-origin requests. <br><br> For server-side requests, use the value br_server. For native-app requests, use the value br_app. |
catalogViews | Required | string | A list of catalog views that you want to see in your suggestions. You must specify the catalog name within the catalog view. For Product catalogs, the catalog name is the same value as your domain_key. <br><br> A catalog_views value contains the view_ids within a catalog separated by a colon. If you pass multiple catalogs in catalog_views, they must be pipe-separated. Attributes suggestions are enabled for the first two catalogs mentioned as part of catalog_views and only for the first view passed in each of the first two catalogs. <br><br> For example, &catalog_views=product:store1,store2|recipe:premium|articles would return text and attribute suggestions for the product catalog in the store1 view, and for the recipe catalog in the premium view; only text suggestions will be displayed for the articles catalog. <br><br> The example value shown here, <i>pacifichome</i>, is included for your convenience to send a request with <b>Try It</b>. |
q | Required | string | Your site visitor's partial search query that Autosuggest should operate on. <br><br> You can percent encode spaces between terms as %20, or you can leave the spaces unencoded. <br><br> The example value shown here, <i>cha</i>, is included for your convenience to send a request with <b>Try It</b>. |
refUrl | Required | string | The URL of the page or HTTP referrer where the request is started. |
requestId | Required | string | An ID to track site visitor clicks. We recommend generating unique, random values of 13 digits to enable click-tracking. <br><br> Bloomreach doesn't automatically enforce the requirements for this parameter. For example, you can enter test as your value for each instance of the request_id parameter without triggering an error message. However, using a unique value allows us to help you if you encounter a problem. |
requestType | Required | AutosuggestApiRequestTypeEnum | The type of API request. Value should be suggest for Autosuggest requests. |
url | Required | string | The absolute URL of the page where the request is initiated. Do not use a relative URL. <br><br> The example value shown here, <i>https://www.documentation-site.com</i>, is included for your convenience to send a request with <b>Try It</b>. |
userAgent | Optional | string | The user agent of the browser that's making the search request. <br><br> Make sure that this value in your API request is the same as the value in the original request from your user. We optimize pages in part by crawling and gathering data, and the original user_agent lets us distinguish between our internal Bloomreach users who QA pages and everyone else who visits your site. |
userId | Optional | string | The universal customer ID of the user. You only need to pass this field if your particular integration tracks customers this way. The parameter captures user IDs from the customer side, and reuses the information when powering apps or enhancing cross-device linking. In this way, Bloomreach recognizes users in a way that's aligned with your system. <br><br> Use an anonymous string. Don't use email or other personally identifiable information. <br><br> If you do not track users this way, then omit this field. |