Recently viewed widget

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

This API allows you to specifically fetch the "Recently Viewed" personalization widget.

Endpoints

Production: https://pathways.dxpapi.com/api/v2/widgets/personalized/{recently_viewed_widget_id}
Staging: https://pathways-staging.dxpapi.com/api/v2/widgets/personalized/{recently_viewed_widget_id}

The recently_viewed_widget_id can be found in the Widget Configurator in the Dashboard.

📘

Path Params
string
required
Defaults to 1jwy7eg9

The ID of the Recently Viewed widget, which can be found in the Widget Configurator in the Dashboard.

The example value shown here, 1jwy7eg9, is included for your convenience to send a request with Try It.

Query Params
int32
required
Defaults to 6276

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.
The example value shown here, 6276, is included for your convenience to send a request with Try It.

string
required
Defaults to uid%3D7797686432023%3Av%3D11.5%3Ats%3D1428617911187%3Ahc%3D55

A first-party cookie created by the Bloomreach tracking pixel library (BrTrk).
This cookie creates a unique, anonymous identifier for every browser or device.
Use the default value provided, which is already encoded.

string
required
Defaults to bloomreach_devdocs

Your site domain's ID, which is provided by Bloomreach. This ID is for the domain that you want to receive your Bloomreach API requests.

This parameter identifies the specific site version when one account ID hosts multiple site versions with unique characteristics, such as language versions.
The example value shown here, bloomreach_devdocs, is included for your convenience to send a request with Try It.

string
required
Defaults to abh3kjh1kjnd8

An ID to track site visitor clicks. We recommend that you generate unique, random values of 13 digits to enable click-tracking.
The request_id is also important for debugging.

string
required
Defaults to https://www.documentation-site.com

The absolute URL of the page where the request is initiated. Don't use a relative URL.

The example value shown here, https://www.documentation-site.com, is included for your convenience to send a request with Try It.

string

The URL of the page or HTTP referrer where the request is started.

Required if you want to use Targeting.

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.

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 "*"]).
Note that a negative filter on ranges isn't supported.
To provide multiple filters, send multiple filter parameters.
For example, &filter=(price:["*" TO "100"])&filter=(color_groups: ("blue")).

boolean

This parameter enables the Personalized media in grid feature.

If true, the API response includes media objects along with product results.
The content and positions of the media objects are governed by the assets and media rules configured in the Bloomreach dashboard.

int32

The number of matching items to return per results page in the API response. The maximum value is 200.
The result size is used from the Dashboard if it isn't sent in the API.

To enhance performance, limit this value to the number of items that you think is reasonable for a single page of search results.

string

A unique identifier for a specific view of your product catalog.
If you have multiple versions of your site, each with its 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.

string

The Bloomreach-provided authentication key for the Bloomreach account that's sending the request.

Widget API calls are client-side, so you can leave auth_key empty.

string
Defaults to abc123

The universal customer ID of the user. Required for Personalization-based Recommendation widgets.

The parameter captures user IDs from the customer side and reuses the information when powering apps or enhancing cross-device linking.
This way, Bloomreach recognizes users in a way that's aligned with your system.

Use an anonymous string. Don't use email or other personally identifiable information.
The example value shown here, abc123, is included for your convenience to send a request with Try It.

int32
Defaults to 0

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.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

© Bloomreach, Inc. All rights reserved.