The Product List Page shows products for a selected category, including pagination controls and product result counts. The page automatically re-executes the product search whenever the category ID, pagination state, or selected refinement filters change.
This flow demonstrates how a headless storefront can render category-based product experiences using B2B Commerce Product APIs.
| Purpose | HTTP Method | Endpoint |
|---|---|---|
| Search by category and refinements | GET | /commerce/webstores/{webstoreId}/search/product-search |
The endpoint GET /commerce/webstores/{webstoreId}/search/products is also supported. However, prefer the POST-based search API because it supports the complete request body schema, including refinements, field selection, and includePrices. The POST approach also avoids URL length limitations that can occur when multiple refinement filters are applied.
Note
Render Products for a Category
Load the category product listing page.
Build the product search request using the following parameters:
categoryIdpage=0pageSize=12Call the following endpoint to retrieve products for the selected category:
Use the response to render:
The response includes:
productsPage—Contains the product list and total result countRe-run the product search whenever the following values change:
categoryIdPaginate Product Results
Select Previous or Next to navigate between result pages.
Update the page index in the product search request.
Call the following endpoint again with the updated page parameter:
Use the updated response to render the next set of products.
Modify the pageSize parameter in the search request to control pagination behavior, and the number of products returned per page.
To add sorting support, include a sortRuleId in the search request body.
Retrieve available sorting rules using:
j