Skip to content

Features

Some of the features listed here loosely correspond to the features of the endpoints defined in the Notion API. Please note that slightly different terminology is used. Since the term properties is highly overloaded, we call the properties of a data source as a whole schema and refer to the individual properties as data source properties or sometimes columns in the context of a table or view. With page properties, we denote only the properties of a page within a data source that correspond to the properties of the data source schema. In contrast to that, the properties that every page has, e.g., title, icon, last edited by/time, etc., are called page attributes.

General

  • high-level and Pythonic interface for the Notion API
  • caching to avoid unnecessary calls to the Notion API
  • 100% feature parity with the official Notion API

Data sources

  • retrieve a data source by its ID
  • search for a data source by its title
  • create a new data source with a given schema, i.e., properties and their types
  • delete and restore a data source
  • update a data source schema, i.e., adding/removing properties or changing their types
  • change data source properties, e.g., name, formula of formula property, options, etc.
  • read the data source attributes like title, description, cover, icon, etc.
  • change data source attributes like title, description, etc.
  • retrieve all pages of a data source
  • query with filters and sorting to retrieve only specific pages
  • display the content of a data source as a table, e.g., in JupyterLab
  • export to Polars, Pandas, Markdown, HTML, etc.
  • create new pages with properties within the data source respecting the schema

Pages

  • retrieve a page by its ID
  • search for a page by its title
  • create a new page
  • delete and restore a page
  • read page attributes like title, cover, icon, etc.
  • change page attributes like title, cover, icon, etc.
  • read page properties defined by a data source schema
  • change page properties
  • navigate pages using parent and children links
  • retrieve the blocks within a page
  • add or remove blocks within a page
  • view the content of a page as Markdown

Blocks

  • create a new block and append it to a page or a parent block
  • delete a block
  • change the content of a block
  • navigate blocks using references of parent and children

Files

  • upload files to Notion
  • import external files by URL to Notion
  • list all uploads

Users

  • retrieve all users
  • retrieve a user by their ID
  • retrieve own bot user, i.e., self-identify

Comments

  • create a comment in a page or existing discussion thread
  • retrieve unresolved comments from a page or block

Adapters

  • general synchronization capabilities with external services
  • client for Google Tasks API and synchronization adapter to sync Google Tasks with a Notion data source
  • synchronization adapter for Google Sheets API to sync Google Sheets with a Notion data source

Notion API Limitations

Some features that the Notion UI provides are impossible to implement due to limitations of the Notion API itself. These limitations include:

  • creating a Status property or updating the options as well as option groups. Sending a Status property within a create data source call is currently accepted but just ignored, i.e., a data source without the property will show up.
  • creating a Wiki database, which has a special Verification property.
  • updating the data source schema with respect to the options of a select/multi-select property, the formula of a formula property, and synced content.
  • referencing in a formula expression another formula property, e.g., prop("other formula"). Use a substitution instead.
  • creating a two-way relation with the same source and target data source, i.e., self-referencing. The update data source call is currently accepted but only a one-way relation is created, which seems to be a bug within the Notion API itself.
  • setting the icon and cover of a data source.
  • moving pages since a page’s parent cannot be changed.
  • setting a reminder based on date and/or time.
  • modifying the URL of file-like blocks, e.g., File, Image, etc. Replace the block with a new upload instead.
  • creating inline comments to start a new discussion thread.
  • resolving comments or listing unresolved comments.
  • locking or unlocking a page or data source.
  • working with data source button properties.
  • working with place properties.
  • retrieving a list of all custom emojis defined in the workspace.
  • changing the description of a data source property.
  • resolve linked databases, i.e. views to a data source.
  • setting the font and background color independently of each other for rich texts.
  • having a callout block without an icon as sending null is rejected by the Notion API.
  • repositioning a page's cover image.

If you think those limitations should be fixed, let the developers of Notion know 😆