Search products
Search for products matching a specific words or characters given.
Headers
This param is used to determine product pricing, promotions, and subscription rates. If a valid customer group id is provided, pricing details will be retrieved accordingly. If no matching data is found for the specified customer group id, the system will fall back to the default customer group id. If no data is found for the default group either, the highest applicable price will be returned.
Body
Payload for searching products.
Filter expression(s) to narrow results. Omit for no filtering.
Syntax: attribute OPERATOR value
Operators:
Important rules:
- Operators are case-sensitive — must be uppercase (
AND, notand). - String value comparison is case-insensitive —
product_type = Physicalmatchesphysical. - Operator precedence:
NOT>AND>OR. Use parentheses to override. - String values containing whitespace must be wrapped in single quotes.
INtakes comma-separated values in square brackets.- Maximum array nesting depth is 2 levels.
Supported attributes: product_type, categories.name, attributes.key, pricing.listing_price, pricing.selling_price, pricing.tax_rate, product_id, variant_id, product_name, variant_name, tags, sku, stock_available, rating
Combining conditions:
- String: Use
AND/ORoperators inline —"rating > 4 AND product_type = physical" - Array of strings: Conditions are combined with AND —
["rating > 4", "product_type = physical"] - Nested arrays: Inner arrays express OR, outer array expresses AND —
["product_type = physical", ["product_type = bundle", "rating > 4"]]