Search

Notion

Search pages and data sources in a connected Notion workspace by title.

Capability: Workspace knowledge
Current price: $0.0025/request
Availability: Requires connected account

What this API does

Searches titles across everything shared with the connection, optionally filtered to pages or data sources. Needs no ids, so it is the first call against a new Notion connection. Billed per upstream request at $0.0025; one page (up to 100 results) is one request.

Agents select this operation with tool ID notion.search, then check its current inputs and price before a run.

Inputs and outputs

Input

bodyobject · optional

Notion search body. `query` matches titles; omit it to list everything shared. `filter` narrows to one object type.

max_pagesinteger · optional

Maximum number of result pages to request.

minimum: 1 · maximum: 10

Output

pagesnumber

Returned pages value.

resultsarray

Returned results value.

Example request and output

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

{
  "tool_id": "notion.search",
  "input": {
    "body": {
      "query": "Planning",
      "filter": {
        "value": "page",
        "property": "object"
      },
      "page_size": 10
    },
    "max_pages": 1
  }
}

Output

{
  "pages": 1,
  "results": [
    {
      "id": "1b2c3d4e-0000-4000-8000-000000000001",
      "url": "https://app.notion.com/p/Project-roadmap-1b2c3d4e000040008000000000000001",
      "icon": {
        "type": "emoji",
        "emoji": "🗺️"
      },
      "cover": null,
      "object": "page",
      "parent": {
        "type": "page_id",
        "page_id": "1b2c3d4e-0000-4000-8000-000000000002"
      },
      "in_trash": false,
      "is_locked": false,
      "properties": {
        "title": {
          "id": "title",
          "type": "title",
          "title": [
            {
              "href": null,
              "text": {
                "link": null,
                "content": "Project roadmap"
              },
              "type": "text",
              "plain_text": "Project roadmap",
              "annotations": {
                "bold": false,
                "code": false,
                "color": "default",
                "italic": false,
                "underline": false,
                "strikethrough": false
              }
            }
          ]
        }
      },
      "public_url": null,
      "is_archived": false,
      "created_time": "2026-08-01T09:00:00.000Z",
      "last_edited_time": "2026-08-14T15:30:00.000Z"
    }
  ]
}

Errors and limitations

invalid_input: notion rejected the request: body.filter.value should be "page" or "data_source"example: {"body":{"query":"roadmap","filter":{"property":"object","value":"page"},"page_size":10},"max_pages":1}
empty_results: notion returned no results, which usually means nothing is shared with the connection yetIn Notion, open the page or database, then Connections → add the scrollport integration. Search only sees what has been shared with it.

Use Search with Scrollport

Get started

Connect your app account to let your agent use its tools. Your credentials stay private, and you pay only for successful runs.

Connect your first agent to receive $1 trial credit.