Notion APIキー:作成、ページ共有、最初のリクエスト

Notion APIキー

Notion APIキー:トークンを取得して最初の呼び出しを行う | We.Inc

内部コネクションのトークンまたは個人アクセストークンとしてNotion APIキーを取得し、ページを共有して、Notion-Versionヘッダーを設定し、最初のリクエストを送る方法を解説します。

Notion APIキーは、コードがNotion APIに送るトークンです。NotionのDeveloperポータルで内部コネクションを作成し、Configurationタブから APIトークンをコピーしてから、各ページをそのコネクションと共有します。すべてのリクエストには、そのトークンをBearerの値として付け、さらにNotion-Versionヘッダーを付ける必要があります。

Notion APIの基本(developers.notion.com、2026年10月)

  • 項目
  • 値
  • ベースURL
  • 認証ヘッダー
  • Authorization: Bearer <token>
  • Notion-Version(最新)
  • 2026-03-11、すべてのリクエストで必須
  • レート制限(ほとんどのプラン)
  • 1分あたり180リクエスト、平均で1秒あたり3件
  • レート制限(BusinessとEnterprise)
  • 1分あたり600リクエスト、平均で1秒あたり10件
  • 上限を超えた場合
  • コード rate_limited と秒単位の Retry-After を伴うHTTP 429

Notionをサイト、フォーム、エージェントとつなぐには、まずトークンが1つ必要です。Notionには2つの取得方法があります。共有したページだけが見える内部コネクションと、あなた自身として動く個人アクセストークンです。下にページのリンクを貼り付けると、トークンをプレースホルダーのままにした、すぐに実行できるリクエストをこのページが作成します。

  • Developerポータルを開き、ワークスペース用の新しい内部コネクションを作成します。ワークスペースのオーナーである必要があります。
  • コネクションの設定を開き、Configurationタブから APIトークンをコピーします。コードではなく環境変数に保存しましょう。
  • Notionで、コネクションに使わせる各ページを開き、右上の ••• メニューをクリックして「コネクションを追加」を選び、自分のコネクションを選びます。
  • Authorization: Bearer ヘッダー、Notion-Version ヘッダー、Content-Type: application/json を付けてリクエストを送ります。
  • Notionでは開けるページなのにエラーになる場合、たいていはそのページがコネクションと共有されていません。
  • コード内で Notion-Version の値を固定しましょう。新しいバージョンではレスポンスの形が変わることがあり、固定しておけば自分でアップグレードを決めるまでアプリが安定します。
  • レート制限は1分あたりの平均です。書き込みはキューに入れ、429が返ったら Retry-After の秒数だけ待ってから再試行しましょう。
  • トークンをフロントエンドのコードに入れないでください。サーバーやサーバーレス関数からNotionを呼び出し、ブラウザーはそちらとやり取りするようにします。

よくある質問

Notion APIキーはどこにありますか?

内部コネクションの場合は、Developerポータルでコネクションを開き、Configurationタブで APIトークンを確認します。個人アクセストークンは作成時に一度だけ表示されるので、すぐにコピーしましょう。

内部コネクションと個人アクセストークン、どちらを使うべきですか?

内部コネクションは1つのワークスペースに紐付き、共有されたページにしかアクセスできないため、サイトや自動化に向いています。個人アクセストークンはあなた自身として認証されます。他のワークスペースがインストールするアプリ向けのパブリックコネクションでは、代わりにOAuthを使います。

APIがページを見つけられないと言うのはなぜですか?

Notionでは、コネクションがページを読み書きする前に、各ページを手動でコネクションと共有する必要があります。ページの ••• メニューから「コネクションを追加」を使い、もう一度試してください。

Notion APIのレート制限はどれくらいですか?

2026年10月時点で、Notionはほとんどのプランで1分あたり180リクエスト(1秒あたり約3件)、BusinessとEnterpriseで1分あたり600リクエストとしています。超えたリクエストには、rate_limited コード付きのHTTP 429が返ります。

どの Notion-Version を使えばよいですか?

Notionのバージョン管理に関するページでは、2026-03-11 が最新バージョンとされています。このヘッダーはすべてのREST APIリクエストで必須で、公式SDKを使えば自動で設定されます。

ページIDを見つける

  • ページIDは、Notionページのリンクの末尾、タイトルの後ろにある32文字の16進数です。下のビルダーは貼り付けたリンクからそれを見つけ、APIが返すのと同じハイフン区切りのUUID形式で書き出します。

トークンを安全に保つ

  • トークンを持っている人は誰でも、共有されたページ上でコネクションに許可されていることを何でもできます。トークンはホスティングサービスのシークレット設定に保管し、万一どこか公開の場所に貼り付けてしまったら新しいものを作成しましょう。

最初のリクエスト

ターミナルでトークンを一度設定してから、検索エンドポイントを呼び出します。クエリを指定しなければ、コネクションと共有されたすべてのページが返ります。

ターミナル

プレースホルダーを本物のトークンに置き換えるのは自分のターミナルの中だけにし、コミットするファイルには絶対に書かないでください。

notion.js(サーバー専用)

サーバーやサーバーレス関数から素の fetch で呼び出し、429のときは簡単な待機を入れます。

Notionリクエストビルダー

NotionページのリンクかIDを貼り付け、実行する操作を選んでください。リクエストは $NOTION_API_KEY を使うので、先にターミナルでその変数を設定しておきます。ブラウザーの外には何も送られません。

リクエスト

ページのプロパティを読み取る

ページのコンテンツブロックを読み取る

共有ページをタイトルで検索する

NotionページのリンクまたはID

検索語

ページID:{v}

そのテキストにはまだ32文字のページIDが見つかりません。

リクエストをコピー

コピーしました

無料で始める · クレジットカード不要

関連: ガイド|Webマーケティングと集客を学ぶ

製品

ご利用いただける方

機能

リソース

会社情報

サイトマップを見る