> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xinobi-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Bucket

> Search a bucket for videos, images, and text

Search all content in a bucket using natural language.

## Parameters

<ParamField body="query" type="string" required>
  What to search for
</ParamField>

<ParamField body="unique_id" type="string" required>
  Bucket ID
</ParamField>

<ParamField body="top_k" type="integer" default="10">
  Max results
</ParamField>

<RequestExample>
  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://memoryapi-production.up.railway.app/search",
      headers={"X-API-Key": "xinobi"},
      json={
          "query": "beach sunset",
          "unique_id": "your-bucket-id"
      }
  )
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "results": {
      "media": [
        {"videoNo": "VI123", "videoName": "beach", "score": 0.89}
      ],
      "text": [
        {"id": "456", "content": "Amazing sunset at the beach!"}
      ]
    }
  }
  ```
</ResponseExample>