Notion は何をしますか？
公式 ntn CLI を優先して使用してください。ntn が利用できない場合や生リクエストの方が明確な場合にのみ curl を使用してください。
セットアップ
npm install -g ntn
ntn --version
ntn login
スクリプト/ヘッドレス認証:
export NOTION_API_TOKEN=secret_or_ntn_token
export NOTION_API_VERSION=2026-03-11
ntn api は自動的に Authorization と Notion-Version を設定します。デフォルトでは CLI ログインを使用し、NOTION_API_TOKEN が設定されている場合はそれを使用します。
検査
ntn doctor
ntn api ls
ntn api ls --json
ntn api v1/comments --help
ntn api v1/comments --spec -X POST
ntn api v1/comments --docs -X POST
ページ
Markdown ファーストなヘルパー:
ntn pages get <page-id>
ntn pages get <page-id> --json
ntn pages create --parent page:<page-id> --content '# タイトル\n\n本文'
ntn pages create --parent data-source:<data-source-id> < page.md
ntn pages update <page-id> --content '# 更新済み'
ntn pages update <page-id> < page.md
ntn pages trash <page-id> --yes
注意:
pages getは Markdown を出力し、ページプロパティは frontmatter として表示されます。- コンテンツ入力:
--content、標準入力、または TTY のエディタ。 - 親参照:
page:<id>、database:<id>、data-source:<id>。 - プロパティ/テンプレート/フル Pages API については
ntn api v1/pagesを使用してください。
データソース
ntn datasources resolve <database-id>
ntn datasources resolve <database-id> --json
ntn datasources query <data-source-id>
ntn datasources query <data-source-id> --limit 50 --json
ntn datasources query <data-source-id> --sort '日付 desc'
ntn datasources query <data-source-id> --filter '{"property":"完了","checkbox":{"equals":true}}'
データベース ID がある場合は resolve を使用してください。クエリにはデータソース ID が必要です。
生 API
ntn api v1/users/me
ntn api v1/search query=ロードマップ page_size:=10
ntn api v1/pages 'parent[data_source_id]='"$DS_ID" 'properties[名前][title][0][text][content]=新しいアイテム'
ntn api "v1/pages/$PAGE_ID" -X PATCH in_trash:=true
ntn api "v1/blocks/$PAGE_ID/children" -X PATCH \
'children[0][type]=paragraph' \
'children[0][paragraph][rich_text][0][text][content]=こんにちは'
入力構文:
path=value: 文字列ボディフィールド。path:=json: 型付き JSON ボディフィールド。name==value: クエリパラメータ。Header:Value: リクエストヘッダ。--data '<json>'またはより大きなボディには標準入力 JSON。- リクエストごとに 1 つのボディソースのみ。
ファイル
ntn files create < image.png
ntn files create --filename photo.png --content-type image/png < /tmp/photo
ntn files create --external-url https://example.com/photo.png
ntn files get <upload-id>
ntn files list
Workers
ntn workers new
ntn workers deploy
ntn workers list --json
ntn workers runs list --json
ntn workers runs logs <run-id>
Workers を使用するには、Business/Enterprise プランとワークスペースでの有効化が必要な場合があります。
curl フォールバック
curl -sS "https://api.notion.com/v1/users/me" \
-H "Authorization: Bearer $NOTION_API_TOKEN" \
-H "Notion-Version: 2026-03-11" \
-H "Content-Type: application/json"
バージョン注意
- 現在の最新 API バージョン:
2026-03-11。 archivedではなくin_trashを使用してください。- ブロックの追加位置指定には、フラットな
afterではなくpositionを使用します。 transcriptionブロックはmeeting_notesに名称変更されました。- データベースは複数のデータソースを含むことができます。ページの親は通常
data_source_idを使用します。