# Deep search

POST `/deep-search`

This endpoint lets you do a deep search with an AI-generated personalized response. Deep search is used on Agora for subjective search queries. 

**Headers**

| Header          | Type   | Description   |
| --------------- | ------ | ------------- |
| `Authorization` | string | Bearer token. |

**Request body**

```json
{
  "query": "wireless headphones"
}
```

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
  "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
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}