Functionalities of the Notion Public API for a developer

Max Großmann
1 min readMay 13, 2021

As written in my last blog post, the notion api is finally released for the public!

In this blog i want to give an overview of whats possible now from a developer perspective.

Databases

  • Retrieve information about a database (title of the page, list of all properties with types, information when page was created)
  • Query entries inside a database (e.g. value of a column ≥ 10)
  • List all databases in a workspace

Pages

  • Retrieve information about a notion page (last edited date, all page properties)
  • Create a new page (Define content as block objects and custom properties)
  • Update properties of a page

Blocks

  • Return children of a given block
  • Create and append new children block to another block

Users

  • Retrieve information about a user (e.g. Name, Email, Avatar-URL)
  • List notion users inside a notion workspace. Pagination is supported

Search

  • Search for pages. The query-Partner will check against the page titles

A detailed list and sample requests and responses can be found in the notion developer documentation:

https://developers.notion.com/reference

Feel free to check out my list of all open source apps that were build on top of the notion API. I would highly appreciate if you contribute to this open source project!

https://github.com/MaaxGr/open-source-notionapi-apps

--

--