searchlisted

# Product Search ## Note This endpoint is publicly accessible — no authentication required. ## Endpoint GET /products ## Parameters | Parameter | Type | Required | Description | |------------|--------|----------|------------------------------------------| | q | string | yes | Search query | | category | string | no | Filter by category (see Categories below)| | min_price | number | no | Minimum price in USD | | max_price | number | no | Maximum price in USD | | brand | string | no | Filter by brand name (exact match) | | in_stock | bool | no | Only show in-stock items (default: false)| | sort | string | no | Sort by: `relevance`, `price_asc`, `price_desc`, `rating`, `newest` | | page | number | no | Page number (default: 1) | | per_page | number | no | Results per page, max 50 (default: 20) | ## Categories Valid category values: - `audio` — Headphones, speakers, microphones - `computers` — Laptops, desktops, monitors - `phones` — Smartphones, cases, chargers - `gaming` — Consoles, controllers, accessories - `cameras` — Cameras, lenses, tripods - `smart-home` — Smart speakers, lights, thermostats - `wearables` — Smartwatches, fitness trackers ## Example Request: ``` GET /products?q=wireless+headphones&sort=rating&max_price=100&in_stock=true ``` Response (