go-notion
go-notion is a client for the Notion API, written in Go.
Features
The client supports all (non-deprecated) endpoints available in the Notion API, as of May 15, 2021:
- Retrieve a database
- Query a database
- Retrieve a page
- Create a page
- Update page properties
- Retrieve block children
- Append block children
- Retrieve a user
- List all users
- Search
Installation
$ go get github.com/dstotijn/go-notion
Getting started
To obtain an API key, follow Notion’s getting started guide.
Code example
First, construct a new Client
:
import "github.com/dstotijn/go-notion"
(...)
client := notion.NewClient("secret-api-key")
Then, use the methods defined on Client
to make requests to the API. For example:
page, err := client.FindPageByID("18d35eb5-91f1-4dcb-85b0-c340fd965015")
if err != nil {
// Handle error...
}
Status
The Notion API is currently in public beta.
v1.0
of the module is released.
To do
- Write tests
- Provide examples