> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Image Search

> Search the Naver image vertical — 100 images per page with thumbnail, full-resolution URL, dimensions and source.

Search the **Naver image** vertical. Backed by Naver's image JSON API, it returns up to 100 images per page, each with its thumbnail and full-resolution URLs, dimensions, title and source site.

**Credits:** 5

## Authorization

**X-API-Key** `string` *required*

Your ScrapeBadger API key.

## Query Parameters

**query** `string` *required*

Search keywords.

**page** `integer` (default: 1)

1-based result page. Each page returns up to 100 images.

## Response

**query** `string`

**page** `integer`

**result\_count** `integer`

**results** `ImageResult[]`

Images.

**ImageResult**

**position** `integer`

**img\_id** `string`

Naver image id.

**title** `string`

**url** `string`

The page the image was found on.

**source** `string`

Source site name.

**thumbnail\_url** `string`

**original\_url** `string`

Full-resolution image URL.

**width** `integer`

**height** `integer`

**published** `string`

**published\_at** `string`

Absolute publish timestamp (ISO 8601), when present.

## Example

```bash cURL theme={null}
curl "https://scrapebadger.com/v1/naver/image?query=한라산+설경&page=1" \
  -H "X-API-Key: YOUR_API_KEY"
```

```javascript Node.js theme={null}
const res = await fetch(
  "https://scrapebadger.com/v1/naver/image?" +
    new URLSearchParams({"query": "한라산 설경", "page": "1"}),
  { headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const data = await res.json();
```

```python Python theme={null}
import requests

res = requests.get(
    "https://scrapebadger.com/v1/naver/image",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "한라산 설경", "page": "1"},
)
data = res.json()
```

```json Response theme={null}
{
  "query": "한라산 설경",
  "page": 1,
  "result_count": 100,
  "results": [
    {
      "position": 1,
      "img_id": "blog_12345",
      "title": "한라산 겨울 설경",
      "url": "https://blog.example.com/hallasan",
      "source": "제주여행블로그",
      "thumbnail_url": "https://search-phinf.example.net/thumb/12345.jpg",
      "original_url": "https://blogfiles.example.net/hallasan_full.jpg",
      "width": 1920,
      "height": 1280
    }
  ]
}
```

## Errors

| Status | Meaning |
| - | - |
| `422` | Naver served a challenge instead of content — **not billed**. Retry; it succeeds. |
| `502` | Unexpected upstream failure — **not billed**. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.