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

# Search

> Find rows, subpages, and databases the integration can see, by title.

Returns rows and subpages (`page`) and databases (`data_source`) whose title contains the query. Page content isn't searched. The default order is most recently edited first.

Archived rows don't appear. Trashed databases and their rows don't appear either.

**Authorization** `string` *required*

`Bearer <token>`. See [Tokens](https://developers.bottari.ai/auth/tokens.md).

**Bottari-Version** `string`

Optional. Only `2026-03-11` is accepted. Without it, the current version is used. A different value returns 400.

**filter\_properties** `string[]`

Property names or IDs to include on rows. Each database has different properties, so unknown ones are skipped.

**query** `string`

The text to find. Leave it out to return everything the integration can see.

**filter** `object`

Filters by object type and trash state. You can use both.

**filter**

**property** `string`

Only `object` is accepted.

**value** `string`

`page` or `data_source`.

**in\_trash** `boolean`

If `true`, returns only trashed rows and subpages.

**sort** `object`

`{ "timestamp": "last_edited_time", "direction": "ascending" }` or `{ "property": "relevance" }`. `relevance` gives the default order.

**start\_cursor** `string`

`next_cursor` from the previous response. The query, filter, and sort have to match.

**page\_size** `number` (default: 100)

1 to 100.

**results** `object[]`

`page` and `data_source` objects.

**next\_cursor** `string | null`

The cursor for the next set.

**has\_more** `boolean`

`true` if there's more.

**type** `string`

Always `page_or_data_source`.

## Errors

| Status | `code` | Cause |
| - | - | - |
| 400 | `validation_error` | An unknown body key, a wrong filter or sort, or a cursor from another search. |

See [Common rules](https://developers.bottari.ai/api-reference/overview.md#errors) for shared errors.

```bash curl theme={null}
curl https://api.bottari.ai/v1/search \
  -X POST \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "order",
    "filter": {
      "property": "object",
      "value": "page"
    },
    "sort": {
      "timestamp": "last_edited_time",
      "direction": "descending"
    },
    "page_size": 10
  }'
```

```json 200 theme={null}
{
  "object": "list",
  "results": [
    {
      "object": "page",
      "id": "exampleRow01",
      "created_time": "2026-01-15T02:30:00.000Z",
      "last_edited_time": "2026-01-15T03:10:00.000Z",
      "created_by": {
        "object": "user",
        "id": "11111111-1111-4111-8111-111111111111"
      },
      "last_edited_by": {
        "object": "user",
        "id": "11111111-1111-4111-8111-111111111111"
      },
      "in_trash": false,
      "cover": null,
      "icon": null,
      "parent": {
        "type": "data_source_id",
        "data_source_id": "exampleDb001",
        "database_id": "exampleDb001"
      },
      "is_archived": false,
      "is_locked": false,
      "properties": {
        "Name": {
          "id": "title",
          "type": "title",
          "title": [
            {
              "type": "text",
              "text": {
                "content": "Review January orders",
                "link": null
              },
              "annotations": {
                "bold": false,
                "italic": false,
                "strikethrough": false,
                "underline": false,
                "code": false,
                "color": "default"
              },
              "plain_text": "Review January orders",
              "href": null
            }
          ]
        }
      },
      "url": "https://app.bottari.ai/t/exampleTeam1/p/exampleRow01",
      "public_url": null
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "page_or_data_source",
  "page_or_data_source": {},
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.