Connect REST API Developer Guide
jNewer Version Available
Commerce Webstore Search Products
- Resource
-
1/commerce/webstores/webstoreId/search/products - Available version
- 58.0
- Requires Chatter
- No
- HTTP methods
- GET
- Request parameters for GET
-
Parameter Name Type Description Required or Optional Available Version categoryId String Category ID returns results for products in this category or its subcategories. Required if searchTerm isn’t specified 58.0 effectiveAccountId String ID of the buyer account or guest buyer profile for which the request is made. If unspecified, the default value is determined from context. Optional 58.0 fields String[] Product fields to return in search results. Search results include fields you have access to. Required 58.0 grouping Product Search Grouping Input Specifies whether to group products in search results and how to group them. If unspecified, the default is the value specified in . Optional 58.0 includeQuantityRule Boolean Specifies whether to include purchase quantity rule information for products in search results (true) or not (false). If unspecified, defaults to false. Optional 58.0 page Integer Number of the page you want returned. Starts at 0. If you don’t specify a value or if you specify 0, the first page is returned.
Optional 58.0 pageSize Integer Specifies the number of items per page. Valid values are from 1 through 200. If unspecified, defaults to 20.
When multiplying the page and pageSize property values together, they can’t exceed 5000. For example, for a pageSize of 20, you can specify a page value up to 250.
Optional 58.0 refinements String List up to nine refinements (facets) for search results. Buyers or shoppers can select up to 20 values for each refinement. The refinements parameter is encoded as a Base64 string from the JSON representation of the Distinct Value Refinement Input. Optional 58.0 searchTerm String List of up to 32 space-separated search terms. Required if categoryId isn’t specified 58.0 sortRuleId String ID of the sort rule that specifies the order of products in the search results. If unspecified, the default sort type is relevancy. Optional 58.0 - Response body for GET
- Commerce Product Search Results