https://github.com/iansinnott/notion-utils
https://github.com/iansinnott/notion-utils
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/iansinnott/notion-utils
- Owner: iansinnott
- Created: 2021-08-09T04:16:29.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2021-08-18T08:04:13.000Z (almost 5 years ago)
- Last Synced: 2025-03-18T03:41:39.806Z (over 1 year ago)
- Language: TypeScript
- Homepage: notion-utils.vercel.app
- Size: 666 KB
- Stars: 9
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Notion Utils
🚧 WIP 🚧 This repo is very much a work in progress. Just a heads up.
## Official API
Utilize the Typescript utils.
### Dev
```sh
# With no debugging
NOTION_TOKEN='secret_...' DEBUG= node dist/backup.js
# Run with debugging
NOTION_TOKEN='secret_...' DEBUG=1 node dist/backup.js
```
## Unofficial API
Utilize the Python utils. These utils are very much experimental and not (yet) meant to resemble anything approaching stable code.
That being said, the official API is not yet powerful enough to meet all user needs, so some functionality still requires the unofficial API.
Examples:
* Accessing everything in a workspace
* A workaround is to put all your Notion data under a single page, and then share that page with an official API integration. However, if you really want to access everything within a workspace you will need the unofficial API.
* Multiple work spaces
* There is currently no official API for this.
That being said, it's still early days and the Notion devs are iterating on the official API. Hopefully soon anything will be possible!
## Directory Structure
All of the place. It's also changing often enough that any description might be out of date. There's not very much code though, so hopefully it's approachable.