Search

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
  }'

{
  "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"
}

POST

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
  }'

{
  "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"
}

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.

string

required

Bearer <token>. See Tokens.

string

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

string[]

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

string

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

object

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

Show filter

string

Only object is accepted.

string

page or data_source.

boolean

If true, returns only trashed rows and subpages.

object

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

string

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

number

default:"100"

1 to 100.

object[]

page and data_source objects.

string | null

The cursor for the next set.

boolean

true if there’s more.

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 for shared errors.

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
  }'

{
  "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"
}

Common

Users

Databases and data sources

Pages

Blocks

Comments

Search

Errors

​Errors

Errors