Salesforce Shopper Products
✓ 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.
Use for: I need to get product details from a Salesforce Commerce Cloud store, Retrieve pricing and availability for a specific product ID, List all products in a category for a product listing page, Get variation attributes for a configurable product
Not supported: Does not handle order management, checkout, basket operations, or inventory writes — use for read-only product and category retrieval only.
Retrieve product details, pricing, promotions, availability, and category hierarchies for online storefronts powered by Salesforce Commerce Cloud. The API serves shopper-facing product data including variation attributes, promotional pricing, inventory levels, and images — enabling headless commerce experiences on any channel. Supports personalization via Shopper Context and server-side caching for high-traffic product listing pages.
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.
1
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 | sh2
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 instanceJentic 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
Access variation product attributes to display size, color, and style options
Surface promotional pricing and callout messages based on shopper context
Personalize product responses using the Shopper Context API for device or segment targeting
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.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Complementary
Stripe API
Payment processing API often used alongside commerce product catalogs
Use Stripe for payment processing after retrieving product and pricing data from the Shopper Products API
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.
GET STARTED