IVGraphIVGraph API ドキュメント
IVGraphは、Notionワークスペースのグラフデータ（ノード、ノード間の関係、検索、ページの内容）にアクセスするためのREST APIを提供しています。インテグレーションの構築、LLMエージェントの動作を支える仕組み、プログラムによるNotionワークスペースの分析に活用できます。
ベースURL
| 環境 | URL |
|---|---|
| 本番環境 | https://ivgraph.com/api/ |
| 本番環境（V1） | https://ivgraph.com/v1/ |
認証
IVGraphは2つの認証方式に対応しています。
| 方式 | 用途 | ヘッダー |
|---|---|---|
| JWT（Notion OAuth） | Webアプリ、ユーザーセッション | Authorization: Bearer <jwt_access_token> |
| サービストークン | LLMエージェント、自動化、CI/CD | Authorization: Bearer ivg_<token> |
サービストークンで始める
- Notion OAuthでivgraph.comにログインします
- プロフィール → サービストークンに移動します
- 必要なスコープ（例：
graph:search、graph:read）を指定してトークンを作成します - 次のようにリクエストでトークンを使用します。
curl -H "Authorization: Bearer ivg_your_token_here" \
"https://ivgraph.com/v1/graph/search?q=project&workspace_id=YOUR_WORKSPACE_ID"APIのレイヤー
| レイヤー | ベースパス | 認証 | 説明 |
|---|---|---|---|
| V1 LLM API | /v1/graph/ |
サービストークン | LLMエージェント向けの読み取り専用グラフアクセス |
| グラフAPI | /api/notion-graph/ |
JWT | グラフデータ全体（ノード + エッジ） |
| 検索API | /api/search/ |
JWT | 全文検索、セマンティック検索、ハイブリッド検索 |
| 内部API | /api/ |
JWT | 認証、請求、インテグレーション、スタイルルール |
| 公開 | /api/stats/public/ |
なし | プラットフォームの統計、ヘルスチェック |
レート制限
| API | 上限 | 適用範囲 |
|---|---|---|
| V1（サービストークン） | 10秒あたり20リクエスト（バースト）、15分あたり600リクエスト | トークンごと |
| ユーザーAPI（JWT） | 毎分100リクエスト | ユーザーごと |
| 匿名 | 毎分20リクエスト | IPごと |
エラー形式
すべてのエラーはJSON形式で返されます。
{
"error": "Short error message",
"detail": "Extended description (optional)"
}エラーの完全なリファレンスについては、エラーとレート制限をご覧ください。
LLMエージェント向け
機械可読形式のドキュメント：
ivgraph.com/llms.txt— 簡潔なAPI概要ivgraph.com/llms-full.txt— 使用例を含むドキュメントの完全版