Notion API - Public Beta (English)

Search by title

GEThttps://api.notion.com/v1/search

Request

query

string

required

The text that the API compares page and database titles against.

filter

object

required

A set of criteria, value and property keys, that limits the results to either only pages or only databases. Possible value values are "page" or "database". The only supported property value is "object".

value

string

required

property

string

required

sort

object

required

A set of criteria, direction and timestamp keys, that orders the results. The only supported timestamp value is "last_edited_time". Supported direction values are "ascending" and "descending". If sort is not provided, then the most recently edited results are returned first.

direction

string

required

timestamp

string

required

{
  "query": "string",
  "filter": {
    "value": "string",
    "property": "string"
  },
  "sort": {
    "direction": "string",
    "timestamp": "string"
  }
}

Request samples

Responses

OK(200)

Bad Request(400)

HTTP Code: 200

Content Type : JSONapplication/json

object {0}

--data '{
    "query":"External tasks",
    "filter": {
        "value": "database",
        "property": "object"
    },
    "sort":{
      "direction":"ascending",
      "timestamp":"last_edited_time"
    }
  }'

Last modified: 2 years ago