Postman Collections Welcome Kit

Postman Collections

Bloomreach provides a public Postman workspace that contains a Welcome Kit (DataConnect environment and collection) for the Catalog Management, Search and Merchandising, and Recommendations and Pathways APIs in order to try out and make work with the APIs easier for developers.
This guide will walk you through accessing our Postman collections and tailoring them to enhance your workflow.


Before you Begin

It is recommended to go through the relevant API Reference to get familiar with the API before using the Postman Collections.

Getting Started

Step 1: Access Postman Collections

  1. To access the latest version of the collection, follow this link: Welcome Kit: Catalog Management.
  2. Begin by forking the collection by clicking on the "Create a Fork" option as depicted below:
  1. Likewise, fork the "Env.Catalog_Management" Environment File in the Environments tab.


Alternatively, you also have the option to export the collection and environment files.

Step 2: Customize Your Environment

  1. Upon importing the collections and environment files, customize the following environment variables:
Environment VariableValue
hostProduction: | Staging:
search_hostProduction: | Staging:
auto_suggest_hostProduction: | Staging:
recs_pathways_hostProduction: | Staging:
account_idYour site's numerical Bloomreach account ID
domain_keyYour site domain's ID, which is provided by Bloomreach
account_auth_keysThis variable represents the auth_key, which is a Bloomreach-provided authentication key for the Bloomreach account that's sending the request
api_keyAn API key shared for the account to use the Catalog Management APIs. This access key must be placed in the Authorization header
catalog_nameName of the product catalog being used with the Catalog Management API
content_catalog_nameName of the content catalog being used with the Content Search API
urlThe absolute URL of the page where the request is initiated. Do not use a relative URL
ref_urlThe URL of the page or HTTP referrer where the request is started
br_uid_2The br_uid_2 cookie is a first-party cookie created by the Bloomreach tracking pixel library
request_idAn ID to track site visitor clicks. We recommend you generate unique random values of 13 digits to enable click-tracking

Step 3: Explore and Customize Requests

  1. Within the collection, you will find API requests organized into folders.
  2. Tailor requests to your specific requirements by adjusting parameters, environment settings, and request bodies.

Step 4: Execute and Test

Execute individual requests to test your customized API interactions.

Step 5: Save and Share (Optional)

  1. To retain your configurations and collections, save your custom workspace by clicking on "Save" at the top right.
  2. Collaborate on API development tasks by sharing your workspace with team members.