# Naver Image Search API (https://www.socialcrawl.dev/platforms/naver/image-search)

> Searches Naver Image — image search across crawled Korean web. Returns images under `data.items[]` with `title`, `link` (image URL), `thumbnail` (preview URL), `sizeheight`, and `sizewidth`.

TL;DR: `GET /v1/naver/image/search` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Free-text search term (UTF-8). Required. |
| `display` | no | Number of items to return per page. Defaults to 10. Standard cap 100 (local corpus caps at 5). |
| `start` | no | 1-indexed offset for pagination. Defaults to 1. Standard cap 1000 (local corpus caps at 1). |
| `sort` | no | Sort order. Accepted values: sim\|date. Defaults to `sim` (relevance) when the corpus supports sort. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/naver/image/search?query=%ED%95%9C%EB%9D%BC%EC%82%B0" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search Naver images with an API?

Send a GET request to /v1/naver/image/search with a keyword in the query parameter. SocialCrawl searches images crawled across the Korean web and returns the image link, a thumbnail URL, and pixel dimensions for each result under data.items.

### What fields does the Naver Image endpoint return?

Each item includes title, link (the full-size image URL), thumbnail (a preview URL), and sizeheight and sizewidth in pixels. The dimensions let you filter for high-resolution images before downloading the full-size file.

### Can I sort and paginate Naver image results?

Yes. sort accepts sim (relevance, the default) and date (newest first). Use display to set page size and start as the offset to page through more images for the same query beyond the first response.

### What does the Naver Image corpus search across?

It searches images indexed from the Korean web, so it surfaces visuals tied to Korean blogs, news, and shopping pages. This makes it a strong source for Korean-context image discovery that general image APIs tend to under-index.

### How much does the Naver Image Search API cost?

Each image search costs 1 credit on the standard tier, no matter how many images come back. New accounts get 100 free credits with no credit card required, enough to run roughly 100 image searches before any charge applies.

See the full Naver API: https://www.socialcrawl.dev/platforms/naver

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I search Korean web images with an API?
- What is the SocialCrawl Naver Image Search API?