画像検索結果の照会

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

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

参考

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

リクエスト

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

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

リクエストヘッダ

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` `sim`: 正確度降順 `date`: 日付降順
`filter`	String	Optional	サイズ別の検索結果フィルタ `all` (デフォルト) \| `large` \| `medium` \| `small` `all`: すべての画像 `large`: 大きな画像 `medium`: 中サイズの画像 `small`: 小サイズの画像
`format`	String	Optional	レスポンス結果 `json`(デフォルト) \| `xml`

リクエスト例

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

curl --location --request GET https://naverapihub.apigw.ntruss.com/search/v1/image?query=コーヒー&display=2&start=1&sort=date&filter=large&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	-	画像が検索されたページのタイトル
`link`	String	-	画像の URL
`thumbnail`	String	-	サムネイル画像の URL
`sizeheight`	String	-	画像の高さ (ピクセル)
`sizewidth`	String	-	画像の幅 (ピクセル)

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

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

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": 25055897,
    "start": 1,
    "display": 2,
    "items": [
        {
            "title": "<b>コーヒー</b>一杯とコーヒー豆",
            "link": "https://{imageHost}/{imagePath}.jpg",
            "thumbnail": "https://search.pstatic.net/sunny/?type=b150&src=https%3A%2F%2F{imageHost}%2F{imagePath}.jpg",
            "sizeheight": "1023",
            "sizewidth": "682"
        },
        {
            "title": "<b>コーヒー</b>と本のある静物",
            "link": "https://{imageHost}/{imagePath}.jpg",
            "thumbnail": "https://search.pstatic.net/sunny/?type=b150&src=https%3A%2F%2F{imageHost}%2F{imagePath}.jpg",
            "sizeheight": "682",
            "sizewidth": "1023"
        }
    ]
}

Documentation Index