Elastic Path Search Profiles API

Search Profiles are configuration objects that control how search queries are executed. They provide a powerful way to customize search relevance, filtering, and ranking without requiring code changes, enabling merchandisers and business users to optimize the search experience.### How Search Profiles WorkA Search Profile defines:- **Which fields to search**: Select which product fields are included in search queries- **Field weights**: Assign relative importance to each field for relevance ranking- **Default filters**: Apply business rules that filter results for all searches- **Boost rules**: Promote or demote products based on specific conditions- **Match type**: Control how scores from multiple fields are combinedWhen a search request is made, the system uses the specified profile (or the default profile) to configure the search behavior.### Search Profile Components| Component | Description ||-------------------|-------------------------------------------------------------------------------------------|| `slug` | Unique identifier used to reference the profile in search requests || `fields` | List of fields to search with optional weights for relevance ranking || `filters` | Default filter expressions applied to all searches using this profile || `boosts` | Rules for promoting or demoting products based on conditions || `text_match_type` | How to combine scores when multiple fields match (`max_score`, `max_weight`, `sum_score`) |### Field WeightsField weights control how important each field is when ranking search results. Higher weights mean matches in that field contribute more to the relevance score. Weights must be in the range `[0, 15]`.**Example**: A profile with `name` (weight 10) and `description` (weight 5) will rank products with search term matches in the name higher than those with matches only in the description.### FiltersProfile filters enforce business rules that apply to all searches:- Ensure only live/published products appear in results- Restrict results to specific categories or channels- Hide products based on visibility settingsMultiple filters are combined with OR logic, then ANDed with any filters in the search request.### Boost RulesBoost rules allow you to promote or demote products in search results:- **Positive weights**: Push matching products to the top of results- **Negative weights**: Push matching products to the bottom (burying)- **Zero weight**: No effect on rankingRules are evaluated in weight order, and the first matching rule determines the product's boost.### Text Match Types| Type | Description ||--------------|----------------------------------------------------------------------------------------|| `max_score` | Uses the highest score from any single matching field. Prioritizes match quality. || `max_weight` | Uses the score from the highest-weighted matching field. Prioritizes field importance. || `sum_score` | Sums weighted scores from all matching fields. Rewards multi-field matches. |### Default ProfileEach store has a default search profile that is used when no profile is specified in the search request. You can set any profile as the default using the set default endpoint.### Use Cases- **A/B testing**: Create multiple profiles with different configurations to test search relevance- **Channel optimization**: Different profiles for web, mobile, and B2B channels- **Seasonal merchandising**: Profiles that boost seasonal or promotional products- **Customer segmentation**: Different ranking strategies for different customer tiers