interface ItemWidgetRequest {
    _br_uid_2: string;
    account_id: number;
    auth_key?: string;
    domain_key: string;
    fields?: string;
    filter?: string | string[];
    item_ids: string;
    ref_url: string;
    request_id: number;
    rows: number;
    segment?: string;
    sort?: string;
    start: number;
    url: string;
    view_id: string;
}

Hierarchy (view full)

Properties

_br_uid_2: string

First Party cookie that provides unique identifier

account_id: number

Account ID

auth_key?: string

Authentication Key

domain_key: string

Product/Content catalog name

fields?: string

A comma-separated list of fields to be sent in the request.

Alternatively, you may configure the fields in the Widget Configurator in the Dashboard instead. This parameter is required if not sent via the Dashboard.

filter?: string | string[]

The filter parameter applies a faceted filter to the returned products, searching for products that fit your parameter values. Any facet that you want to filter must be in your feed.

Attributes must be enabled and mapped by Bloomreach. Let your Bloomreach representative know which attributes in your content feed you want to apply as filters to search results.

You can filter results based on numeric ranges. For example, &filter=(price:["100" TO "*"]). Please note that a negative filter on ranges is not supported.

To provide multiple filters, send multiple filter parameters. For example, &filter=(price:["*" TO "100"])&filter=(color_groups: ("blue"))

item_ids: string

Comma-separated list of Item IDs. Specifies access to a particular set of items. For product catalog, this would be the PID(s).

ref_url: string

URL of the page or HTTP referrer where request started

request_id: number

ID to track site visitor clicks

rows: number

The number of matching items to return per results page in the API response. The maximum value is 200.

segment?: string

Segment identifier. Ranking happens only among items with that segment. Example - view_id:ie

sort?: string

Sorts results based on the field value in ascending, descending, or another combination of orders. You can sort any fl field. Value is a field name, followed by asc/desc for ascending/descending order respectively.

start: number

The number of the first item on a page of results. For example, the first item on the first page is 0, making the start value also 0. The maximum value is 10000.

url: string

Absolute URL of the page where the request initiated

view_id: string

A unique identifier for a specific view of your product catalog. If you have multiple versions of your site, each with their own product catalog characteristics like product titles and prices, then add view_id to your call. Bloomreach uses your view_id parameter value to display the right product information for your customers based on their individual site views. You can enter any string value to identify the specific site catalog view. This string must be consistent in your pixel, API, and product catalog.