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

# Search Objects

> Fuzzy search across a bucket.

Fuzzy search across a bucket, optimized for dashboard browsers with "Folders First" logic.

## Authentication

Requires an API Key via `Authorization`, `X-API-Key`, or `apiKey` query parameter.

## Query Parameters

<ParamField path="bucketName" type="string" required>
  The name of the bucket to search within.
</ParamField>

<ParamField query="q" type="string">
  Fuzzy search query.
</ParamField>

<ParamField query="parent" type="string">
  Filter by parent directory (e.g., `images/`).
</ParamField>

<ParamField query="limit" type="number" default="20">
  Maximum number of results to return.
</ParamField>

<ParamField query="offset" type="number" default="0">
  For pagination.
</ParamField>

## Logic

Automatically prioritizes Folders over Files. Parent filtering enables hierarchical browsing while searching.

## Example

```bash theme={null}
curl "https://cdn.sacul.cloud/api/search/my-bucket?q=logo&parent=branding/" \
    -H "Authorization: Bearer <your-api-key>"
```