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

タイトルで検索

GET
/v1/search
統合で共有されたすべての親または子ページとデータベースを検索します。
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.notion.com/v1/search' \
--header 'Notion-Version;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "query": "string",
    "filter": {
        "value": "string",
        "property": "string"
    },
    "sort": {
        "direction": "string",
        "timestamp": "string"
    },
    "start_cursor": "string",
    "page_size": 0
}'
Response Response Example
200 - 成功例
{
  "object": "list",
  "results": [
    {
      "object": "page",
      "id": "954b67f9-3f87-41db-8874-23b92bbd31ee",
      "created_time": "2022-07-06T19:30:00.000Z",
      "last_edited_time": "2022-07-06T19:30:00.000Z",
      "created_by": {
        "object": "user",
        "id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
      },
      "last_edited_by": {
        "object": "user",
        "id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
      },
      "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": []
        },
        "Food group": {
          "id": "A%40Hk",
          "type": "select",
          "select": {
            "id": "5e8e7e8f-432e-4d8a-8166-1821e10225fc",
            "name": "🥬 Vegetable",
            "color": "pink"
          }
        },
        "Price": {
          "id": "BJXS",
          "type": "number",
          "number": null
        },
        "Responsible Person": {
          "id": "Iowm",
          "type": "people",
          "people": []
        },
        "Last ordered": {
          "id": "Jsfb",
          "type": "date",
          "date": null
        },
        "Cost of next trip": {
          "id": "WOd%3B",
          "type": "formula",
          "formula": {
            "type": "number",
            "number": null
          }
        },
        "Recipes": {
          "id": "YfIu",
          "type": "relation",
          "relation": []
        },
        "Description": {
          "id": "_Tc_",
          "type": "rich_text",
          "rich_text": [
            {
              "type": "text",
              "text": {
                "content": "A dark green leafy vegetable",
                "link": null
              },
              "annotations": {
                "bold": false,
                "italic": false,
                "strikethrough": false,
                "underline": false,
                "code": false,
                "color": "default"
              },
              "plain_text": "A dark green leafy vegetable",
              "href": null
            }
          ]
        },
        "In stock": {
          "id": "%60%5Bq%3F",
          "type": "checkbox",
          "checkbox": false
        },
        "Number of meals": {
          "id": "zag~",
          "type": "rollup",
          "rollup": {
            "type": "number",
            "number": 0,
            "function": "count"
          }
        },
        "Photo": {
          "id": "%7DF_L",
          "type": "url",
          "url": null
        },
        "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-954b67f93f8741db887423b92bbd31ee"
    },
    {
      "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"
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "page_or_database",
  "page_or_database": {}
}

Requestパラメータ

Headerパラメータ
Notion-Version
string 
必須
Request Bodyパラメータapplication/json
query
string 
可選
APIがページとデータベースのタイトルを比較するテキスト。
filter
object 
可選
結果を注文する一連の基準、方向、タイムスタンプキー。サポートされている唯一のタイムスタンプ値は「last_edited_time」です。サポートされている方向値は「昇順」と「降順」です。ソートが提供されていない場合は、最近編集した結果が最初に返されます。
value
string 
必須
property
string 
必須
sort
object 
可選
結果をページのみまたはデータベースのみに制限する一連の基準、値、およびプロパティキー。可能な値は「ページ」または「データベース」です。サポートされているプロパティ値は「オブジェクト」のみです。
direction
string 
必須
timestamp
string 
必須
start_cursor
string 
可選
前の応答で返されたカーソル値は、指定されている場合、応答をカーソルの後に始まる結果に制限します。指定されていない場合は、結果の最初のページが返されます。詳細については、ページネーションを参照してください。
page_size
integer 
可選
応答に含める全リストの項目数。最大:100。
Examples

Response

🟢200OK
application/json
Body
object
string 
必須
results
array [object {12}] 
必須
object
string 
必須
id
string 
必須
created_time
string 
必須
last_edited_time
string 
必須
created_by
object 
必須
last_edited_by
object 
必須
cover
object 
必須
icon
object 
必須
parent
object 
必須
archived
boolean 
必須
properties
object 
必須
url
string 
必須
next_cursor
null 
必須
has_more
boolean 
必須
type
string 
必須
page_or_database
object 
必須
🟠400不正なRequest
🟠429レート制限
更新日時 2023-04-28 10:38:59
前へ
コメントを取得
Built with