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

> Searches map.naver.com places — Korean business / point-of-interest catalog. Returns places under `data.items[]` with `title`, `link`, `category`, `description`, `telephone`, `address` (legal-district), `roadAddress` (street), `mapx` / `mapy` (KATEC coordinates). Note: `display` is capped at 5 and `start` at 1 for this corpus — Naver returns HTTP 400 above those bounds.

TL;DR: `GET /v1/naver/local/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: random\|comment (display max 5, start max 1). Defaults to `sim` (relevance) when the corpus supports sort. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/naver/local/search?query=%EA%B0%95%EB%82%A8%EC%97%AD%20%EC%B9%B4%ED%8E%98" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search Naver Local places with an API?

Send a GET request to /v1/naver/local/search with a place or business keyword in the query parameter. SocialCrawl returns Korean POI results including name, category, address, road address, telephone, and KATEC map coordinates under data.items.

### Why is the Naver Local display limited to 5?

Naver caps the Local corpus at display=5 and start=1 — request more than five results or a higher start offset and Naver returns a 400 error. Keep display at or below 5 and start at 1 to get a clean response every time.

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

Each item includes title, link, category, description, telephone, address, roadAddress, and mapx/mapy coordinates in the KATEC system. Convert mapx/mapy to WGS84 if you need standard latitude and longitude for mapping.

### What sort options does Naver Local support?

sort accepts random (the default ordering) and comment (sorted by number of reviews). Use comment to surface the most-reviewed businesses for a query — handy for ranking restaurants, cafes, or shops by visible popularity.

### How much does the Naver Local API cost?

Each Naver Local search costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required, so you can run roughly 100 place lookups before paying. Note the 5-result cap when budgeting calls.

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 places with the Naver Local API?
- How does the SocialCrawl Naver Local API compare to Naver's Open API?