Authorization
Token-based authentication header in the form of
<YOUR_LAYERS_TOKEN>
.Headers
Path Parameters
The url-encoded search query.
Body
Product attributes to include in the Response. By default all attributes are included in the response.
ULID identifier from the Prepare Search endpoint for optimized search execution. When provided, uses pre-computed embeddings and query expansions. See the Search API Optimization Guide.
Parameters to fine-tune the search results.
Refer to our dedicated Filter Expressions guide to learn more about filter expressions.
Facets to be included.
If the count of each facet value should be calculated
If you want a min/max range for numeric facets such as price.
Apply discounts to products, variants, or collections. When provided, price-based sorting and filtering will use discounted prices. See the Discount Entitlements guide for detailed usage.
User identity information for tracking and personalization. Automatically managed by the Storefront Pixel; required for headless integrations.
Response
The total number of results.
The current page number.
The total number of pages.
The attribution token.
If
includeFacetRanges
is true
then an object with keys of the facet attribute code and value is an object with min/max.If
retrieveFacetCount
is true
then an object with keys and values of the specified attributes.