Search · Public
Búsqueda pública (multi-shop) — JWT OAuth2 o anonymous.
Visual product search with image upload
Search products by uploading an image. Supports two modes:
Search products in a specific shop using natural language
Semantic search with AI-powered intent detection and guided filters. Use appliedFilters to apply user-selected filters from guidedFilters response. Pass guidedFilters from previous response to avoid regenerating them (iterative filtering). Use conversationId to enable conversational search with history (up to 10 turns). Use sortBy to order results: relevance (default), price_asc, price_desc, rating, newest, popularity, discount. Use mentionedProductIds (comma-separated UUIDs) to indicate products the user selected in the UI.
Instant search suggestions without AI
Fast autocomplete suggestions (< 50ms) from popular queries, categories, and brands. Does not call Gemini AI. Use this for real-time dropdown suggestions while user types.
Search products across all shops using natural language
Global semantic search using ONLY natural language queries. All filtering (price, category, brand, etc.) is detected automatically from the query text by AI. Example: 'gaming laptop with 16GB RAM under $1500'. Pass guidedFilters from previous response to avoid regenerating them (iterative filtering). Use sortBy to order results: relevance (default), price_asc, price_desc, rating, newest, popularity, discount.
Autocomplete suggestions
Autocomplete suggestions