Salesforce Shopper Products

Name: Shopper Products API
Brand: Shopper Products
Availability: InStock

✓ Official Vendor SpecE CommerceStorefrontoauth24 EndpointsREST

For Agents

Fetch product details, prices, promotions, and category trees from Salesforce Commerce Cloud storefronts. Supports bulk product retrieval (up to 24 per call) and category navigation.

Install Jentic One Beta

Connect the Shopper Products to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Shopper Products, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Shopper Products API.

Retrieve full product details including images, prices, promotions, and inventory availability

Fetch up to 24 products in a single bulk request for product listing pages

Navigate category hierarchies and subcategories for storefront navigation

GET STARTED

Start building with Shopper Products API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Shopper Products API for, with concrete tasks.

★ AI Agent Product Data Retrieval

AI agents use the Shopper Products API through Jentic to fetch real-time product information for conversational commerce, recommendation engines, or automated catalog synchronization. An agent discovers the getProducts endpoint via Jentic's intent search, retrieves product details including pricing and availability, and uses the data to answer shopper queries or populate external channels — all without manual SFCC configuration.

Retrieve full product details for product ID 'summer-dress-001' from organization 'myOrg' including prices, images, and availability using the getProduct endpoint

Headless Product Listing Pages

Build product listing pages on custom storefronts, mobile apps, or marketplace channels by fetching up to 24 products per request. The API returns images, prices, promotions, and stock status for each product, with server-side caching ensuring sub-100ms response times for high-traffic pages. Supports filtering by category assignment and sorting by price or relevance.

Fetch the first 24 products from the 'womens-clothing' category for organization 'myOrg' using the getProducts endpoint with category refinement

Category Navigation for Storefront Menus

Retrieve category hierarchies and subcategory relationships to render navigation menus, breadcrumbs, and faceted browse experiences on headless storefronts. Each category includes its display name, description, parent-child links, and assigned products. The Categories API supports both top-level listing and individual category detail retrieval.

Get the category tree starting from root category 'apparel' for organization 'myOrg' and list all child subcategories using the getCategory endpoint

Promotional Pricing Display

Surface active promotions and discounted pricing for products based on shopper context, device type, or segment membership. The API returns both regular and promotional prices alongside callout messages that can be rendered on product detail pages. Personalization rules defined in Business Manager are automatically applied when a Shopper Context is set.

Retrieve product 'running-shoes-pro' with promotional pricing applied for a mobile shopper context using the getProduct endpoint with shopper context headers

Key Endpoints

4 endpoints — retrieve product details, pricing, promotions, availability, and category hierarchies for online storefronts powered by salesforce commerce cloud.

METHOD

PATH

DESCRIPTION

GET

/organizations/{organizationId}/products/{id}

Get full details for a single product

GET

/organizations/{organizationId}/products

Get multiple products by IDs (up to 24)

GET

/organizations/{organizationId}/categories/{id}

Get a single category with subcategories

GET

/organizations/{organizationId}/categories

Get multiple categories by IDs

GET

/organizations/{organizationId}/products/{id}

Get full details for a single product

GET

/organizations/{organizationId}/products

Get multiple products by IDs (up to 24)

GET

/organizations/{organizationId}/categories/{id}

Get a single category with subcategories

GET

/organizations/{organizationId}/categories

Get multiple categories by IDs

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Salesforce SLAS OAuth tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped shopper tokens — raw client secrets, SLAS credentials, and refresh tokens never enter the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'get product details from Commerce Cloud') and Jentic returns matching Shopper Products operations with their input schemas, including required organizationId and product ID parameters.

Time to first call

Direct SFCC integration: 3-5 days for SLAS OAuth setup, organization configuration, and endpoint discovery. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Shopper Products API through Jentic.

What authentication does the Shopper Products API use?

The API uses OAuth 2.0 via the Shopper Login and API Access Service (SLAS). You need a shopper access token with the appropriate product-read scopes configured in your SLAS client ID. Through Jentic, SLAS tokens are managed in the MAXsystem vault so agents never handle raw client credentials or token refresh logic directly.

Can I retrieve multiple products in a single API call?

Yes. The GET /organizations/{organizationId}/products endpoint accepts up to 24 product IDs as query parameters and returns full details for each, including images, prices, promotions, and availability. This is optimized for populating product listing pages in a single request.

What are the rate limits for the Shopper Products API?

Salesforce Commerce Cloud applies per-tenant rate limits based on your subscription tier. Typical limits are 200 requests per second for shopper APIs. Server-side JWA caching reduces origin hits for repeated product queries, with TTL configurable in Business Manager Feature Switches.

How do I fetch product data through Jentic for an AI agent?

Install the SDK with pip install jentic, then search for 'get product details from Salesforce Commerce Cloud'. Jentic returns the getProduct operation with its input schema including organizationId and product ID parameters. Load the schema and execute the call — the OAuth token exchange is handled automatically by the MAXsystem vault.

Does the API return promotional pricing information?

Yes. Product responses include both regular and promotional prices when active promotions apply. Non-conditional product promotions show discounted prices directly. Basket-level and shipping promotions are not included in product responses — those appear only in basket API calls. Callout messages are always returned regardless of promotion type.

Can I personalize product responses by shopper segment?

Yes. Set values in the Shopper Context API (device type, customer group, or custom attributes) and the Shopper Products API applies matching personalization rules. For example, you can return mobile-specific pricing or segment-exclusive promotions. Personalized responses bypass the JWA cache when the context affects product-promotion data.

Is this API free to use?

The Shopper Products API is included with Salesforce Commerce Cloud subscriptions (B2C Commerce). There is no separate per-call charge, but you need an active Commerce Cloud license. API access is provisioned through Account Manager with appropriate SLAS client configuration.