Search files and folders

Regionalus.api.brault.app— follows the region selector in the top bar

Keyword, semantic and natural-language search over everything the key’s creator can see. Consumes the search rate bucket on every call.

Authorization

apiKey

AuthorizationBearer <token>

API key from Settings → Developers

In: header

Query Parameters

limit?number

Range1 <= value <= 100

Default50

cursor?string

Opaque cursor from a previous response.

q*string

Keyword and natural-language query.

Lengthlength <= 500

scope?string

brandspace, library:<library_id> or folder:<folder_id>.

Match^(brandspace|library:[A-Za-z0-9_-]{1,64}|folder:[A-Za-z0-9_-]{1,64})$

Default"brandspace"

Response Body

`application/json`

curl -X GET "https://example.com/v1/search?q=string"

{  "object": "list",  "has_more": true,  "next_cursor": "string",  "data": [    {      "object": "file",      "id": "string",      "kind": "image",      "name": "string",      "extension": "string",      "mime": "string",      "size": 0,      "status": "processing",      "library_id": "string",      "folder_id": "string",      "external_url": "string",      "duration_ms": 0,      "resolution": "1920x1080",      "created_at": "2019-08-24T14:15:22Z",      "created_by_id": "string",      "trashed_at": "2019-08-24T14:15:22Z",      "thumbnail_url": "string",      "version": {        "count": 0,        "active_number": 0,        "active_id": "string"      }    }  ],  "natural_language": {    "parsed_query": {},    "scope_intent": "current"  }}

Authorization

Query Parameters

Response Body

200application/json

defaultapplication/json

`application/json`

`application/json`