ウェブページ検索結果の照会

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

NAVER検索のウェブページ検索結果を照会します。

参考

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

リクエスト

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

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

リクエストヘッダ

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/webkr?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>`タグで囲む

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

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

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:28 +0900",
    "total": 94515854,
    "start": 1,
    "display": 2,
    "items": [
        {
            "title": "<b>コーヒー</b> - ナムウィキ",
            "link": "https://namu.wiki/w/%EC%BB%A4%ED%94%BC",
            "description": "<b>コーヒー</b>(coffee)は、<b>コーヒーの</b>木の種子(コーヒー豆)を焙煎して挽き、抽出した飲み物である。"
        },
        {
            "title": "<b>コーヒー</b> - ウィキペディア韓国語版",
            "link": "https://ko.wikipedia.org/wiki/%EC%BB%A4%ED%94%BC",
            "description": "<b>コーヒー</b>(英語: coffee、咖啡、珈琲、カベ、文化語: 黒茶、黒い茶)、<b>コーヒー</b>茶または<b>コーヒー</b>飲料(英語: coffee beverage)は、<b>コーヒーの</b>木の果実の種(<b>コーヒー</b>豆)を焙煎して粉末にしたものを、お湯や水、または蒸気で抽出して飲む、苦味のある濃い茶色の飲料である。色が暗く苦味があり、弱酸性である<b>コーヒー</b>は、主..."
        }
    ]
}

Documentation Index