https://github.com/ketion-so/go-notion

Go written SDK for Notion.so API
https://github.com/ketion-so/go-notion

go golang notion notion-api sdk

Last synced: 5 months ago
JSON representation

Go written SDK for Notion.so API

• Host: GitHub
• URL: https://github.com/ketion-so/go-notion
• Owner: ketion-so
• License: apache-2.0
• Archived: true
• Created: 2021-05-11T03:06:00.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2023-10-19T10:14:31.000Z (over 1 year ago)
• Last Synced: 2024-08-03T17:09:16.822Z (9 months ago)
• Topics: go, golang, notion, notion-api, sdk
• Language: Go
• Homepage: https://pkg.go.dev/github.com/ketion-so/go-notion
• Size: 194 KB
• Stars: 13
• Watchers: 0
• Forks: 1
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-notion - ketion-so/go-notion - Unofficial Go SDK for [Notion.so API](https://developers.notion.com) (APIs)

README

        


    



# go-notion

![GitHub tag (latest SemVer)](https://img.shields.io/github/v/tag/ketion-so/go-notion?color=green)

[![Go Reference](https://pkg.go.dev/badge/github.com/ketion-so/go-notion.svg)](https://pkg.go.dev/github.com/ketion-so/go-notion)

![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/ketion-so/go-notion)

![GitHub Repo stars](https://img.shields.io/github/stars/ketion-so/go-notion)

[![Go Report Card](https://goreportcard.com/badge/github.com/ketion-so/go-notion)](https://goreportcard.com/report/github.com/ketion-so/go-notion)

 [![Renovate enabled](https://img.shields.io/badge/renovate-enabled-brightgreen.svg)](https://renovatebot.com/)

[![Test](https://github.com/ketion-so/go-notion/actions/workflows/test.yml/badge.svg)](https://github.com/ketion-so/go-notion/actions/workflows/test.yml)

[![reviewdog](https://github.com/ketion-so/go-notion/actions/workflows/reviewdog.yml/badge.svg)](https://github.com/ketion-so/go-notion/actions/workflows/reviewdog.yml)

[![Coverage Status](https://coveralls.io/repos/github/ketion-so/go-notion/badge.svg?branch=main)](https://coveralls.io/github/ketion-so/go-notion?branch=main)

[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.0-4baaaa.svg)](code_of_conduct.md)

Go written [Notion](https://www.notion.so) SDK.

*Note: The [Notion API](https://developers.notion.com/) is in beta phase*

## Supported APIs

It supports all APIs for Notion API (as for 2021-05-15).

* [x] Blocks

* [x] Databases

* [x] Pages

* [x] Search

* [x] Users

Is this package needs update, please raise an issue or a PR.

## Installation

Include this  in your code as below:

```golang

import "github.com/ketion-so/go-notion/notion"

```

or using `go get`

```console

$  go get -u github.com/ketion-so/go-notion

```

## Usage

Initialize the client as below:

```golang

client := notion.NewClient("access token")

```

Here are some examples:

## List Dashboard

```golang

resp, _ := client.Databases.List(ctx)

fmt.Println(resp.Databases)

```

## Get user

```golang

user, _ := client.Users.Get(ctx, "user ID")

```

## License

This tool is released under Apache License 2.0. See details [here](./LICENSE)