Use the Shopper APIs

This section contains guidance and information for specific APIs in the Shopper API family.

For the full, current API list, use the B2C Commerce API references.

Common Use Case Mappings 

Building a Product Listing Page (PLP) 

  1. Shopper Search - Get search results with filters and facets
  2. Shopper Products - Retrieve product details for search results
  3. Shopper Context - Apply customer-specific pricing/availability

Building a Product Detail Page (PDP) 

  1. Shopper Products - Get product details, variations, images
  2. Shopper Promotions - Show applicable promotions
  3. Shopper Baskets - Enable add-to-cart functionality

Building a Checkout Flow 

  1. Shopper Login - Authenticate customer or continue as guest
  2. Shopper Checkout (Baskets) - Display cart contents and calculate totals
  3. Shopper Customers - Retrieve/update shipping and billing addresses
  4. Shopper Checkout (Orders) - Submit and confirm order

Implementing Personalization 

  1. Shopper Login - Authenticate shopper
  2. Shopper Context - Set customer groups, effective dates, source codes
  3. Shopper Products/Search - Retrieve personalized results based on context

Additional Resources 

  • For ongoing changes and newly added APIs, monitor the Commerce API release notes.
  • For Storefront Next implementation guidance, see Storefront Next Developer Guide and Login and Registration Support in Storefront Next.
  • Shopper Login (SLAS): Get tokens for interacting with B2C Commerce API and what is needed for different types of logins, such as logging in as an agent on behalf of a customer, logging in as a system on behalf of a customer, or merging shopper profiles between different login providers, for example: Facebook or Google.
  • Shopper Context: Maintain a shopper’s state as the shopper navigates across the site, for example: set specific customer groups, specific source codes, or other things that would change the experience for the shopper.
  • Shopper SEO: Allows headless implementations or customer implemented storefronts to determine whether a given URL should reference a product category or content asset.

Next Steps 

Use the following links to optimize your storefront’s performance and security: