Overview
Boost rules let you promote or demote products in search and browse results based on product attributes. Rules are applied post-ranking — only on results that already match the query.
- Boost (
boost > 0): pushes matching products toward the top
- Bury (
boost < 0): pushes matching products toward the bottom
- Rules are only applied when
sortBy is relevance or optimization_score
Authentication
All requests must include an API key via the x-api-key header.
Rate Limits
List Boost Rules
Returns all boost rules for the workspace.
Create Boost Rule
Returns 201 Created with the created rule.
Condition Fields
Boost Range
Update Boost Rule
Partial update — only provided fields are changed.
Returns 200 OK with the updated rule.
Delete Boost Rule
Returns 204 No Content.Última modificação em 12 de março de 2026