Skip to main content
GET
https://cdn.sacul.cloud
/
api
/
search
/
{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.

​
Query Parameters

​
bucketName
string
required
The name of the bucket to search within.
​
q
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.

​
Logic

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

​
Example

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