百科事典検索結果の照会

Classic/VPC環境で利用できます。

NAVER検索の百科事典検索結果を照会します。

参考

百科事典検索には検索 APIが使用され、検索 APIの1日あたりの呼び出し上限は25,000回です。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド	URI
GET	/search/v1/encyc

リクエストヘッダ

NAVER API HUBで共通して使用されるヘッダの詳細は、NAVER API HUBのリクエストヘッダをご参照ください。

リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`query`	String	Required	検索キーワード UTF-8でエンコード
`display`	Integer	Optional	一度に表示する検索結果の数 `1`~`100` (デフォルト: `10`)
`start`	Integer	Optional	検索の開始位置 `1`~`1000` (デフォルト: `1`)
`format`	String	Optional	レスポンス結果 `json`(デフォルト) \| `xml`

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request GET https://naverapihub.apigw.ntruss.com/search/v1/encyc?query=コーヒー&display=2&start=1&format=json
--header X-NCP-APIGW-API-KEY-ID: {Client ID}
--header X-NCP-APIGW-API-KEY: {Client Secret}

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`lastBuildDate`	String	-	検索結果が生成された時間
`total`	Integer	-	検索結果の総数
`start`	Integer	-	検索の開始位置
`display`	Integer	-	一度に表示する検索結果の数
`items`	Array	-	個々の検索結果リスト: items

items

itemsの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`title`	String	-	百科事典の見出し検索キーワードと一致する部分は`<b>`タグで囲む
`link`	String	-	百科事典項目の説明の URL
`description`	String	-	百科事典項目の説明の内容を要約したパッセージ情報検索キーワードと一致する部分は`<b>`タグで囲む
`thumbnail`	String	-	サムネイル画像 URL

レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

HTTPステータスコード	コード	メッセージ	説明
400	`SE01`	Incorrect query request (無効なクエリリクエストです)	APIリクエスト URLのプロトコルやパラメータなどにエラーがないか確認
400	`SE02`	Invalid display value (無効な displayの値です)	`display`の値が有効な範囲内であるか確認
400	`SE03`	Invalid start value (無効な startの値です)	`start`の値が有効な範囲内であるか確認
400	`SE04`	Invalid sort value (無効な sortの値です)	`sort`の値に誤字がないか確認
400	`SE06`	Malformed encoding (無効な形式のエンコードです)	検索キーワードを UTF-8でエンコード
404	`SE05`	Invalid search api (存在しない検索 apiです)	APIリクエスト URLに誤字がないか確認
500	`SE99`	System Error (システムエラー)	サーバ内部でエラー発生

参考

NAVER API HUBで共通して使用されるレスポンスステータスコードの詳細は、NAVER API HUBのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "lastBuildDate": "Thu, 11 Jun 2026 18:43:27 +0900",
    "total": 8101,
    "start": 1,
    "display": 2,
    "items": [
        {
            "title": "<b>コーヒー</b>",
            "link": "https://terms.naver.com/entry.naver?docId=1596581&cid=50346&categoryId=50346",
            "description": "<b>コーヒー</b>栄養学事典<b>コーヒー</b>豆を焙煎して粉砕し、独特の色合いと風味を熱湯で抽出した嗜好飲料。抽出液をスプレードライまたはフリーズドライで粉末化すると、インスタント<b>コーヒー</b>(instant coffee)になる。カフェインの覚醒 ",
            "thumbnail": ""
        },
        {
            "title": "<b>コーヒー</b>",
            "link": "https://terms.naver.com/entry.naver?docId=3572338&cid=58988&categoryId=58988",
            "description": "2000年代に入ってから、人々が集まる場所に<b>コーヒー</b>一杯は欠かせないほど、<b>コーヒー</b>は広く親しまれている飲み物として定着した。今やフランチャイズの<b>コーヒー</b>専門店が2000店舗を超えるほど、<b>コーヒー</b>に対する関 ",
            "thumbnail": "http://openapi-dbscthumb.phinf.naver.net/4749_000_5/20170316145457666_J4BH4NW44.jpg/02_0.jpg?type=m160_160"
        }
    ]
}

Documentation Index