PolderAPI

Docs API

Search

Find the pages and databases shared with your integration by title.

Base URLhttps://docs.polder.work

Search pages and databases

POST/api/v1/searchcapability read_content

Returns the pages and databases connected to the integration whose title contains query (case-insensitive). Only titles are searched, as in Notion's API. Without query it returns everything the integration can see. Pages the integration's admin cannot see, and templates, are left out. Database rows are pages and are included. A full-page database appears once, as a database; a linked view of a database is not listed.

Body

Field Type Required Description
query string no Text the title has to contain
filter object no {"property": "object", "value": "page"}. value is page, database or data_source (which returns databases)
sort object no {"timestamp": "last_edited_time", "direction": "ascending"}. direction is ascending or descending (default). Only last_edited_time is supported
start_cursor string no From a previous next_cursor
page_size integer no 1 to 100, default 100

Results come newest edit first unless sort.direction is ascending. The response is a list of page and database objects with type: "page_or_database".

A wrong query, filter or sort returns 400 validation_error.

curl https://docs.polder.work/api/v1/search \
  -H "Authorization: Bearer $POLDER_DOCS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "roadmap", "filter": {"property": "object", "value": "page"}, "page_size": 20}'

{
  "object": "list",
  "results": [
    {
      "object": "page",
      "id": "01k8x2m4t7q9b3n5v6c8d0f2gh",
      "last_edited_time": "2026-10-02T09:30:00.000Z",
      "properties": { "title": { "id": "title", "type": "title", "title": [ { "plain_text": "Roadmap 2027" } ] } },
      "url": "https://docs.polder.work/pages/01k8x2m4t7q9b3n5v6c8d0f2gh"
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "page_or_database",
  "page_or_database": {}
}

Note: This is a title search. It does not search the text inside pages.