Deep search

POST /deep-search

This endpoint lets you do a deep search with an AI-generated personalized response.

Headers

Header	Type	Description
Authorization	string	Bearer token.

Request body

{
  "query": "wireless headphones"
}

Response

200

{
  "status": "success",
  "data": {
    "query": "wireless headphones",
    "aiResponse": "AI-generated conversational response about the products found",
    "description": "Brief description of what this search is about",
    "suggestions": [
      "Alternative search query 1",
      "Alternative search query 2",
      "Alternative search query 3",
      "Alternative search query 4"
    ],
    "otherOptions": {
      "relatedSearches": [
        "Related search 1",
        "Related search 2",
        "Related search 3"
      ],
      "filters": [
        "Filter suggestion 1",
        "Filter suggestion 2"
      ],
      "categories": [
        "Category 1",
        "Category 2"
      ]
    },
    "productCount": 150,
    "topProducts": [
      {
        "name": "Product Name",
        "brand": "Brand Name",
        "storeName": "Store Name",
        "price": 99.99,
        "averageRating": 4.5
      }
    ]
  }
}