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

> Searches Naver web index — general Korean web search (analog of Google web search, scoped to Naver's crawl of the Korean-language web). Returns pages under `data.items[]` with `title`, `link`, and `description`.

TL;DR: `GET /v1/naver/webkr/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: (sort ignored). Defaults to `sim` (relevance) when the corpus supports sort. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/naver/webkr/search?query=%EA%B8%B0%ED%9B%84%EB%B3%80%ED%99%94" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search Naver web documents with an API?

Send a GET request to /v1/naver/webkr/search with your keyword in the query parameter. SocialCrawl searches general Korean web documents from Naver's crawl and returns title, link, and description for each result under data.items.

### How is the web corpus different from the blog or news corpus?

The webkr corpus is general Korean web search — the closest analog to Google web search scoped to Naver's crawl. Blog and news corpora are limited to those specific sources, while webkr spans the broader Korean web in one query.

### What fields does the Naver Web Search endpoint return?

Each item includes a title, a link to the page, and a description snippet. Title and description come HTML-tagged with <b> around matched query terms, which lets you render search highlights without extra processing.

### Can I paginate Naver web search results?

Yes. Use display to set the number of documents per response and start as the offset for the next page. Increment start to walk through more web results for the same query beyond the first response.

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

Each web search costs 1 credit on the standard tier, regardless of how many documents match. New accounts get 100 free credits with no credit card required, enough to run about 100 web searches while you evaluate coverage.

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 the Korean web with the Naver Web Search API?
- How does the SocialCrawl Naver Web Search API compare to Naver's Open API?