/
Search integration
How to get started with Search
Malachyte currently supports query-based search APIs that can be called directly from the frontend. These APIs provide immediate utility—ranging from intelligent fallback handling to full search engine replacement—while allowing search behavior to be customized through portal-driven configurations. Search is designed to work out of the box with no additional setup, while still supporting advanced use cases such as attribution, pagination, and future personalization.
Search APIs
Core Endpoints
| Endpoint | Description |
|---|---|
POST /v1/search | Executes a product search query and returns ranked results |
POST /v1/search/filter | Filters an existing search result set based on provided criteria |
POST /v1/search/sort | Sorts an existing search result set based on a selected ordering |
Capabilities
Available Today
- Search, filter, and sort APIs (
/search,/search/filter,/search/sort) - Typo-tolerant fuzzy matching
- Synonym handling and redirect logic to recover poor or uncommon queries
[!NOTE] Flexible Implementation This system can be implemented in two ways:
- A fallback when an existing search fails.
- A full replacement for an existing search engine.
Portal Support
- Search Playground: A dedicated environment for testing queries and auditing result quality in real-time.
- No-Code Configuration: Portal-driven management allows you to adjust search behavior instantly without requiring frontend code changes or redeployments.
[!TIP] Customers benefit from improved coverage and relevance immediately upon integration, even before advanced features are fine-tuned.