Search

Method

client.search(args: SearchParameters): Promise<SearchResponse>

Parameters

string

The text that the API compares page and data source titles against.

object

A filter to limit the results to pages or data sources.

Show properties

string

Always "object".

string

Either "page" or "data_source".

object

How to sort the results.

Show properties

string

Either "ascending" or "descending".

string

Either "last_edited_time" or "created_time".

string

If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.

number

The number of items from the full list desired in the response. Maximum: 100.

string

Bearer token for authentication. If not provided, the client-level auth is used.

Response

string

Always "list".

string

Always "page_or_data_source".

array

An array of Page objects or DataSource objects that match the search query.

string | null

A cursor to use in the next request to get the next page of results. If null, there are no more results.

boolean

Whether there are more results to fetch.

Example

const response = await client.search({
  query: "External tasks",
  filter: {
    property: "object",
    value: "page",
  },
  sort: {
    direction: "ascending",
    timestamp: "last_edited_time",
  },
})

console.log(response.results)

Pagination

Use the pagination helpers for easy iteration:

import { iteratePaginatedAPI } from "@notionhq/client"

for await (const result of iteratePaginatedAPI(
  client.search,
  { query: "Tasks" }
)) {
  console.log(result)
}

Client

Blocks

Pages

Databases

Data Sources

Users

Comments

File Uploads

Search & OAuth

Helpers

Errors

Method

Parameters

Response

Example

​Method

​Parameters

​Response

​Example

​Pagination

Method

Parameters

Response

Example

Pagination