Ingest product data

👍

Welcome note

Data hub is our new upgraded platform, which we rolled out in August 2025. It offers a single unified integration for passing your data through to your Bloomreach products.

You have access to Data hub if you've implemented with Bloomreach after August 2025.

Customers who have implemented before August 2025 should follow the existing documentation for Engagement, Discovery, and Clarity.

Item collections in Data hub provide a unified way to manage your product catalog data across Bloomreach products. This guide covers the available methods for ingesting product and variant data into an item collection.

Prerequisites

Before ingesting data, first create an item collection in your workspace. Once your collection is set up, send product data using one of the supported methods.

Ingestion methods

Item collections API

The Item collections API is the foundational method for ingesting data into item collections. All other ingestion methods are built on top of this API, making it the most powerful and flexible option available.

When to use

Your organization has development resources or a technical partner.

• You need complete control over data flow and timing.
• You want access to features as soon as they're released.
• You require real-time or near-real-time updates.

How it works

The Item collections API uses a patch-based protocol where you send operations that describe changes to your records. Check the detailed guides on How to use the API to update product source data.

Imports

Imports allow you to extract data directly from source systems without custom API development. 

When to use 

• Your data resides in flat files, databases, or data warehouses.
• You want scheduled, automated data extraction.
• You prefer configuration over custom code.
• You don't need updates more frequently than every 15 minutes. 

How it works

Configure the connection to your data source, map source columns to item collection fields, and schedule extraction runs. The system automatically converts extracted data into the patch format and processes updates. Read the detailed Imports setup guide.