(日本語版)Notion API - Public Beta
  1. ページ
(日本語版)Notion API - Public Beta
  • 概要
  • インテグレーション機能
  • リクエスト制限
  • ステータス コード
  • ブロック
  • ユーザー
  • コメント
  • リンク プレビューのUnfurl属性オブジェクト
  • バージョン変更
    • バージョニング
    • バージョンによる変更
  • ページ
    • ページ
    • ページのプロパティ
  • データベース
    • データベース
    • データベースのプロパティ
  • その他
    • 絵文字オブジェクト
    • ファイルオブジェクト
    • 親オブジェクト
    • リッチテキストオブジェクト
  • エンドポイント
    • 認証
      • 認証
      • Tokenを作成
    • ブロック
      • ブロックを取得
      • ブロックを更新
      • ブロックの子を取得
      • ブロックの子を追加
      • ブロックを削除
    • データベース
      • データベース エントリのフィルタ
      • データベース エントリの並べ替え
      • データベースのプロパティを更新する
      • データベースを作成
      • データベースを取得
      • データベースを更新
      • データベースにクエリを実行
    • ユーザー
      • 全てユーザーのリストを取得
      • トークンのボットユーザーを取得
      • ユーザーを取得
    • ページ
      • ページをアーカイブ
      • ページを作成
        POST
      • ページを取得
        GET
      • ページプロパティアイテムを取得
        GET
      • ページプロパティを更新
        PATCH
    • コメント
      • コメントを作成
      • コメントを取得
    • 検索
      • タイトルで検索
  1. ページ

ページを取得

GET
/v1/pages/{page_id}
指定された ID を使用してPage オブジェクトを取得します。

📘#

応答には、ページコンテンツではなく、ページ プロパティが含まれます。ページ コンテンツを取得するには、retrieve block childrenエンドポイントを使用します。

📘#

ページ オブジェクトの親オブジェクトがデータベースの場合、プロパティ値はデータベース プロパティ スキーマに準拠します。ページ オブジェクトがデータベースの一部でない場合、そのページで使用できる唯一のプロパティ値はそのタイトルです。

制限#

エンドポイントは、ページ プロパティごとに最大 25 のページまたは人物の参照を返します。ページ プロパティに 25 を超える参照が含まれている場合、26 番目以降の参照は Untitled Anonymousとして返されるか、まったく返されない可能性があります。
この制限は、次のプロパティに影響します。
people: 応答オブジェクトが 25 人を超える人を返すことは保証できません。
relation:応答オブジェクトのrelationのhas_more 値は、relationに25 を超える関連ページが含まれている場合trueです。それ以外の場合はhas_moreの値false です。
rich_text: 応答オブジェクトには、最大 25 個の入力されたインライン ページまたは人物のメンションが含まれます。
title: 応答オブジェクトには、最大 25 個のインライン ページまたは人物へのメンションが含まれます。

👍参照が 25 を超えるプロパティの回避策#

ページ プロパティに 25 を超える参照が含まれている場合は、特定のプロパティのページ プロパティの取得エンドポイントを使用して、参照の完全なリストを取得できます。

📘統合機能#

このエンドポイントでは、コンテンツの読み取り機能を備えた統合が必要です。コンテンツの読み取り機能なしでこの API を呼び出そうとすると、403 ステータス コードを含む HTTP 応答が返されます。統合機能の詳細については、機能ガイドを参照してください。

エラー#

ページが存在しない場合、または統合がページにアクセスできない場合は、404 HTTP 応答を返します。
リクエストがリクエスト制限を超えた場合、400 または 429 HTTP レスポンスを返します。
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.notion.com/v1/pages/?filter_properties=' \
--header 'Notion-Version;'
Response Response Example
{
  "object": "page",
  "id": "59833787-2cf9-4fdf-8782-e53db20768a5",
  "created_time": "2022-03-01T19:05:00.000Z",
  "last_edited_time": "2022-07-06T20:25:00.000Z",
  "created_by": {
    "object": "user",
    "id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
  },
  "last_edited_by": {
    "object": "user",
    "id": "0c3e9826-b8f7-4f73-927d-2caaf86f1103"
  },
  "cover": {
    "type": "external",
    "external": {
      "url": "https://upload.wikimedia.org/wikipedia/commons/6/62/Tuscankale.jpg"
    }
  },
  "icon": {
    "type": "emoji",
    "emoji": "🥬"
  },
  "parent": {
    "type": "database_id",
    "database_id": "d9824bdc-8445-4327-be8b-5b47500af6ce"
  },
  "archived": false,
  "properties": {
    "Store availability": {
      "id": "%3AUPp",
      "type": "multi_select",
      "multi_select": [
        {
          "id": "t|O@",
          "name": "Gus's Community Market",
          "color": "yellow"
        },
        {
          "id": "{Ml\\",
          "name": "Rainbow Grocery",
          "color": "gray"
        }
      ]
    },
    "Food group": {
      "id": "A%40Hk",
      "type": "select",
      "select": {
        "id": "5e8e7e8f-432e-4d8a-8166-1821e10225fc",
        "name": "🥬 Vegetable",
        "color": "pink"
      }
    },
    "Price": {
      "id": "BJXS",
      "type": "number",
      "number": 2.5
    },
    "Responsible Person": {
      "id": "Iowm",
      "type": "people",
      "people": [
        {
          "object": "user",
          "id": "cbfe3c6e-71cf-4cd3-b6e7-02f38f371bcc",
          "name": "Cristina Cordova",
          "avatar_url": "https://lh6.googleusercontent.com/-rapvfCoTq5A/AAAAAAAAAAI/AAAAAAAAAAA/AKF05nDKmmUpkpFvWNBzvu9rnZEy7cbl8Q/photo.jpg",
          "type": "person",
          "person": {
            "email": "cristina@makenotion.com"
          }
        }
      ]
    },
    "Last ordered": {
      "id": "Jsfb",
      "type": "date",
      "date": {
        "start": "2022-02-22",
        "end": null,
        "time_zone": null
      }
    },
    "Cost of next trip": {
      "id": "WOd%3B",
      "type": "formula",
      "formula": {
        "type": "number",
        "number": 0
      }
    },
    "Recipes": {
      "id": "YfIu",
      "type": "relation",
      "relation": [
        {
          "id": "90eeeed8-2cdd-4af4-9cc1-3d24aff5f63c"
        },
        {
          "id": "a2da43ee-d43c-4285-8ae2-6d811f12629a"
        }
      ],
      "has_more": false
    },
    "Description": {
      "id": "_Tc_",
      "type": "rich_text",
      "rich_text": [
        {
          "type": "text",
          "text": {
            "content": "A dark ",
            "link": null
          },
          "annotations": {
            "bold": false,
            "italic": false,
            "strikethrough": false,
            "underline": false,
            "code": false,
            "color": "default"
          },
          "plain_text": "A dark ",
          "href": null
        },
        {
          "type": "text",
          "text": {
            "content": "green",
            "link": null
          },
          "annotations": {
            "bold": false,
            "italic": false,
            "strikethrough": false,
            "underline": false,
            "code": false,
            "color": "green"
          },
          "plain_text": "green",
          "href": null
        },
        {
          "type": "text",
          "text": {
            "content": " leafy vegetable",
            "link": null
          },
          "annotations": {
            "bold": false,
            "italic": false,
            "strikethrough": false,
            "underline": false,
            "code": false,
            "color": "default"
          },
          "plain_text": " leafy vegetable",
          "href": null
        }
      ]
    },
    "In stock": {
      "id": "%60%5Bq%3F",
      "type": "checkbox",
      "checkbox": true
    },
    "Number of meals": {
      "id": "zag~",
      "type": "rollup",
      "rollup": {
        "type": "number",
        "number": 2,
        "function": "count"
      }
    },
    "Photo": {
      "id": "%7DF_L",
      "type": "url",
      "url": "https://i.insider.com/612fb23c9ef1e50018f93198?width=1136&format=jpeg"
    },
    "Name": {
      "id": "title",
      "type": "title",
      "title": [
        {
          "type": "text",
          "text": {
            "content": "Tuscan kale",
            "link": null
          },
          "annotations": {
            "bold": false,
            "italic": false,
            "strikethrough": false,
            "underline": false,
            "code": false,
            "color": "default"
          },
          "plain_text": "Tuscan kale",
          "href": null
        }
      ]
    }
  },
  "url": "https://www.notion.so/Tuscan-kale-598337872cf94fdf8782e53db20768a5"
}

Requestパラメータ

Pathパラメータ
page_id
string 
必須
Notionページの識別子
Queryパラメータ
filter_properties
string 
可選
ページに関連付けられたページプロパティ値IDのリスト。このパラメータを使用して、応答を特定のページプロパティ値または値に制限します。複数のプロパティを取得するには、各ページのプロパティIDを指定します。例えば: ?filter_properties=iAk8&filter_properties=b7dh。
Headerパラメータ
Notion-Version
string 
必須

Response

🟢200OK
application/json
Body
object
string 
必須
id
string 
必須
created_time
string 
必須
last_edited_time
string 
必須
created_by
object 
必須
object
string 
必須
id
string 
必須
last_edited_by
object 
必須
object
string 
必須
id
string 
必須
cover
object 
必須
type
string 
必須
external
object 
必須
icon
object 
必須
type
string 
必須
emoji
string 
必須
parent
object 
必須
type
string 
必須
database_id
string 
必須
archived
boolean 
必須
properties
object 
必須
Store availability
object 
必須
Food group
object 
必須
Price
object 
必須
Responsible Person
object 
必須
Last ordered
object 
必須
Cost of next trip
object 
必須
Recipes
object 
必須
Description
object 
必須
In stock
object 
必須
Number of meals
object 
必須
Photo
object 
必須
Name
object 
必須
url
string 
必須
前へ
ページを作成
次へ
ページプロパティアイテムを取得
Built with