内部コネクションのトークンまたは個人アクセストークンとしてNotion APIキーを取得し、ページを共有して、Notion-Versionヘッダーを設定し、最初のリクエストを送る方法を解説します。
Notion APIキーは、コードがNotion APIに送るトークンです。NotionのDeveloperポータルで内部コネクションを作成し、Configurationタブから APIトークンをコピーしてから、各ページをそのコネクションと共有します。すべてのリクエストには、そのトークンをBearerの値として付け、さらにNotion-Versionヘッダーを付ける必要があります。
Notion APIの基本（developers.notion.com、2026年10月）
Notionをサイト、フォーム、エージェントとつなぐには、まずトークンが1つ必要です。Notionには2つの取得方法があります。共有したページだけが見える内部コネクションと、あなた自身として動く個人アクセストークンです。下にページのリンクを貼り付けると、トークンをプレースホルダーのままにした、すぐに実行できるリクエストをこのページが作成します。
内部コネクションの場合は、Developerポータルでコネクションを開き、Configurationタブで APIトークンを確認します。個人アクセストークンは作成時に一度だけ表示されるので、すぐにコピーしましょう。
内部コネクションは1つのワークスペースに紐付き、共有されたページにしかアクセスできないため、サイトや自動化に向いています。個人アクセストークンはあなた自身として認証されます。他のワークスペースがインストールするアプリ向けのパブリックコネクションでは、代わりにOAuthを使います。
Notionでは、コネクションがページを読み書きする前に、各ページを手動でコネクションと共有する必要があります。ページの ••• メニューから「コネクションを追加」を使い、もう一度試してください。
2026年10月時点で、Notionはほとんどのプランで1分あたり180リクエスト（1秒あたり約3件）、BusinessとEnterpriseで1分あたり600リクエストとしています。超えたリクエストには、rate_limited コード付きのHTTP 429が返ります。
Notionのバージョン管理に関するページでは、2026-03-11 が最新バージョンとされています。このヘッダーはすべてのREST APIリクエストで必須で、公式SDKを使えば自動で設定されます。
ターミナルでトークンを一度設定してから、検索エンドポイントを呼び出します。クエリを指定しなければ、コネクションと共有されたすべてのページが返ります。
プレースホルダーを本物のトークンに置き換えるのは自分のターミナルの中だけにし、コミットするファイルには絶対に書かないでください。
サーバーやサーバーレス関数から素の fetch で呼び出し、429のときは簡単な待機を入れます。
NotionページのリンクかIDを貼り付け、実行する操作を選んでください。リクエストは $NOTION_API_KEY を使うので、先にターミナルでその変数を設定しておきます。ブラウザーの外には何も送られません。
リクエスト
ページのプロパティを読み取る
ページのコンテンツブロックを読み取る
共有ページをタイトルで検索する
NotionページのリンクまたはID
検索語
ページID：{v}
そのテキストにはまだ32文字のページIDが見つかりません。
リクエストをコピー
コピーしました
無料で始める · クレジットカード不要