Search Objects

curl --request GET \
  --url https://cdn.sacul.cloud/api/search/{bucketName}

GET

api

{bucketName}

Search Objects

curl --request GET \
  --url https://cdn.sacul.cloud/api/search/{bucketName}

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.

bucketName

string

required

The name of the bucket to search within.

string

Fuzzy search query.

parent

string

Filter by parent directory (e.g., images/).

limit

number

default:"20"

Maximum number of results to return.

offset

number

default:"0"

For pagination.

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

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