Adobe Commerce only. Learn more

Merchandising Services API Developer Guide

This guide provides API reference and usage information for developers and commerce site administrators involved in storefront development, maintenance, and operations.

Developers can use Merchandising Services powered by Channels and Policies APIs to implement large, complex catalogs, and develop highly performant storefront experiences. Merchandising Services provides a data model that separates product data from product context, allowing businesses to compose custom catalogs for different business models, such as B2B, B2C, and D2C and to manage the catalogs in a way that aligns with their go-to-market strategies.

Merchandising Services product data and context

  • Product data provides the details about the products to be sold-sku, attributes, metadata, and assets data, and prices for each item.

  • Product context defines the business context for the products including distribution channels, data access policies for catalog syndication, and language (locale) scope for the catalog.

Developers can use these components together to compose and deliver custom catalogs quickly, without duplicating or refactoring the base catalog data.

API resources

Merchandising Services includes the following APIs to manage product data and product context independently to compose custom catalogs for storefront experiences:

Data Ingestion API—REST API to add and manage product and pricing data for merchandising across multiple business channels and locales. Data includes products, product attribute metadata, price books, and prices. Data can be added to the Merchandising services data pipeline directly using the API or ingested from third-party systems.

Channels and Policies API—GraphQL API that powers the catalog management capabilities available through Adobe Commerce Optimizer. From the UI, you can create distribution channels, locales, and policies to set up and deliver custom, composable catalogs with minimal development effort. For details, see the Adobe Commerce Optimizer Guide.

Storefront API—GraphQL API to access rich view-model (read-only) catalog data to build product-related storefront experiences. The Storefront API is designed to be used by frontend applications to access catalog data.