---
schema_version: "1"
id: 1e38d3f852a4c619fdd0b681263cd7d03f787c7a3c91007a86c085fb23447aef
title: Use the Shopper APIs
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/commerce-api/guides/use-shopper-api.md
canonical_url: https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/use-shopper-api.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 14d1b1716fd9d93500c8e9740cc5812903d3827306d7774706544b370e66247a
products:
  - Composable Storefront
  - Salesforce APIs
---
# 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](https://developer.salesforce.com/docs/commerce/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](https://developer.salesforce.com/docs/commerce/commerce-api/references/about-commerce-api/about.html).
- For Storefront Next implementation guidance, see [Storefront Next Developer Guide](https://developer.salesforce.com/docs/commerce/sfnext/guide/sfnext-get-started-section.html) and [Login and Registration Support in Storefront Next](https://developer.salesforce.com/docs/commerce/sfnext/guide/sfnext-login-support.html).
- [Shopper Login (SLAS):](https://developer.salesforce.com/docs/commerce/commerce-api/guide/slas.html) 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:](https://developer.salesforce.com/docs/commerce/commerce-api/guide/shopper-context-api.html) 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:](https://developer.salesforce.com/docs/commerce/commerce-api/guide/url-resolution.html) 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:

- [Shopper API Performance and Best Practices](https://developer.salesforce.com/docs/commerce/commerce-api/guide/performance.html)
- [Security](https://developer.salesforce.com/docs/commerce/commerce-api/guide/security.html)