(日本語版)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