Search by title

GET

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

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.notion.com/v1/search' \
--header 'Content-Type: application/json' \
--data-raw '{
    "query": "string",
    "filter": {
        "value": "string",
        "property": "string"
    },
    "sort": {
        "direction": "string",
        "timestamp": "string"
    }
}'

Response Example

200 - Success-Search by title

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

Request

Body Params application/json

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

Examples

Responses

🟢200OK

application/json

Body

object {0}

🟠400Bad Request

Modified at 2023-04-28 09:00:42

Search optimizations and limitations

Block