KnowledgeiN検索結果の照会

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

NAVER検索の KnowledgeiN検索結果を照会します。

参考

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

リクエスト

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

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

リクエストヘッダ

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

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

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

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

リクエスト例

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

curl --location --request GET https://naverapihub.apigw.ntruss.com/search/v1/kin?query=コーヒー&display=2&start=1&sort=date&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	-	KnowledgeiN質問の見出し検索キーワードと一致する部分は`<b>`タグで囲む
`link`	String	-	KnowledgeiN質問の URL
`description`	String	-	KnowledgeiN質問の内容を要約したパッセージ情報検索キーワードと一致する部分は`<b>`タグで囲む

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

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

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": 2408172,
    "start": 1,
    "display": 2,
    "items": [
        {
            "title": "1日の<b>コーヒー</b>適正摂取量が気になります",
            "link": "https://kin.naver.com/qna/detail.naver?d1id={d1id}&dirId={dirId}&docId={docId}",
            "description": "1日に<b>コーヒー</b>を何杯まで飲んでも大丈夫でしょうか? カフェインの推奨量と適正摂取基準が... "
        },
        {
            "title": "プラスチック製のタンブラーでミックス<b>コーヒー</b>を飲んでも大丈夫ですか?",
            "link": "https://kin.naver.com/qna/detail.naver?d1id={d1id}&dirId={dirId}&docId={docId}",
            "description": "熱い<b>コーヒー</b>をプラスチック製のタンブラーに入れて飲んでも大丈夫なのか気になります。環境ホルモンが... "
        }
    ]
}

Documentation Index