Search by title

Searches all parent or child pages and data_sources that have been shared with a connection.

POST /v1/search

TypeScript SDK

JavaScript

import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_API_KEY })

const response = await notion.search({
  query: "meeting notes",
  filter: {
    property: "object",
    value: "page"
  },
  sort: {
    direction: "descending",
    timestamp: "last_edited_time"
  }
})

200

{
  "type": "page_or_data_source",
  "page_or_data_source": {},
  "object": "list",
  "next_cursor": "<string>",
  "has_more": true,
  "results": [
    {
      "object": "page",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_time": "2023-11-07T05:31:56Z",
      "last_edited_time": "2023-11-07T05:31:56Z",
      "in_trash": true,
      "is_archived": true,
      "is_locked": true,
      "url": "<string>",
      "public_url": "<string>",
      "parent": {
        "type": "database_id",
        "database_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "properties": {},
      "icon": {
        "type": "emoji",
        "emoji": "😀"
      },
      "cover": {
        "type": "file",
        "file": {
          "url": "<string>",
          "expiry_time": "2023-11-07T05:31:56Z"
        }
      },
      "created_by": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "object": "user"
      },
      "last_edited_by": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "object": "user"
      }
    }
  ],
  "request_status": {
    "type": "complete",
    "incomplete_reason": "query_result_limit_reached"
  }
}

Returns all pages or data_sources , excluding duplicated linked databases, that have titles that include the query param. If no query param is provided, then the response contains all pages or data_sources that have been shared with the connection. The results adhere to any limitations related to an connection’s capabilities.

To limit the request to pages or data sources, use the filter parameter with property: "object" and a value of "page" or "data_source".

To list content in the trash, set filter.in_trash to true. You can combine in_trash with the object filter or use it by itself.

Return fewer page properties

Use the filter_properties query parameter to return only the page properties you need. It works the same way as on Query a data source, with two differences. Search results come from many data sources, so if a name or ID doesn’t exist on a page, search skips it for that page instead of returning an error. Data source results always include their full property schema.

curl -X POST 'https://api.notion.com/v1/search?filter_properties=title&filter_properties=Status' \
  -H 'Authorization: Bearer ntn_...' \
  -H 'Content-Type: application/json' \
  -H 'Notion-Version: 2026-03-11' \
  --data '{"query": "Roadmap", "filter": {"property": "object", "value": "page"}}'

Errors

Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.

The Search endpoint supports pagination. To learn more about working with paginated responses, see the pagination section of the Notion API Introduction.

To search a specific data_source — not all sources shared with the connection — use the Query a data_source endpoint instead.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version · enum<string> · required

The API version to use for this request. The latest version is 2026-03-11.

Available options: 2026-03-11

Query Parameters

filter_properties · string[]

Property names or IDs to include in each page's properties object. Other properties are left out. Repeat the parameter to pass more than one value, for example filter_properties=title&filter_properties=Status. Pages that aren't in a data source always return only title. Search skips names or IDs that don't exist on a page.

Body

application/json

sort · object

Option 1

Option 2

Show child attributes

query · string

start_cursor · string<uuid>

page_size · number

filter · object

Option 1

Option 2

Show child attributes

Response

200

application/json

type · string · required

Allowed value: "page_or_data_source"

page_or_data_source · object · required

object · string · required

Allowed value: "list"

next_cursor · string | null · required

has_more · boolean · required

results · object[] · required

Option 1

Option 2

Option 3

Option 4

Show child attributes

request_status · object

Show child attributes