Search

Search by title

Changed on
post/v1/search

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/search
  • Auth
    HTTP bearer

Query parameters

filter_propertiesstring[]

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.

Headers

Notion-Version'2026-03-11' required

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

Request body

querystring
start_cursorstring uuid
page_sizenumber

Response

type'page_or_data_source' required
page_or_data_sourceEmptyObject required
object'list' required
next_cursorstring nullable required
has_moreboolean required

Example response

{
  "results": [
    {
      "icon": {
        "emoji": "😀"
      }
    }
  ]
}

Changes

  • 52686c6832a8Revision changes
    • info

      added the required property //////////////// to the response with the status

    • info

      added the required property //////////////// to the response with the status

  • 981cafc786b6Revision changes
    • info

      added the required property //////////// to the response with the status

    • info

      added the required property //////////// to the response with the status