scrollport
Back to Connected apps

Search

Notion

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

Capability
Workspace knowledge
Current price
$0.0050/call
Availability
Connected app
Last accepted verification

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.0050; one page (up to 100 results) is one request.

Agents select this operation with tool ID notion.search, then inspect its current executable contract before a run.

Public input and output shape

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

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

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"
    }
  ]
}
Teaching 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.
Updated
18 August 2026

Use Search with Scrollport

Use Scrollport

Scrollport validates tools for connected apps and provides them on a pay-as-you-go basis so your agent can use accounts you already own without receiving sensitive API keys.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.