> ## 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.

# Local Search

> Search Naver Place — local businesses with rating, review count, live opening status, category and addresses.

Search Naver Place, Korea's dominant local-business directory. Each result
carries the `place_id` (use it with
[Place Detail](https://docs.scrapebadger.com/api-reference/endpoint/naver/place.md) and
[Place Reviews](https://docs.scrapebadger.com/api-reference/endpoint/naver/place-reviews.md)), rating and
review count, live opening status, category, both road and lot-number
addresses, and any badges Naver attaches.

**Credits:** 5

## Authorization

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

Your ScrapeBadger API key.

## Query Parameters

**query** `string` *required*

Place search keywords, e.g. `강남 파스타` or a business name.

## Response

**query** `string`

Echo of the requested query.

**result\_count** `integer`

Places returned.

**results** `Place[]`

Local places.

**Place**

**place\_id** `string`

Naver Place id — use it with the detail and reviews endpoints.

**name** `string`

**category** `string`

e.g. `파스타`, `카페`.

**address** `string`

Lot-number (jibun) address.

**road\_address** `string`

Road-name (doro) address.

**phone** `string`

**rating** `number`

Average visitor rating.

**review\_count** `integer`

**is\_open** `boolean`

Whether the place is open right now.

**open\_status\_text** `string`

Human-readable status, e.g. `영업 중`, `21:00에 영업 종료`.

**badges** `string[]`

Labels Naver attaches, e.g. `예약`, `주차`.

**url** `string`

Naver Place page URL.

**rank** `integer`

1-based rank within the results.

**url** `string`

The Naver Place search URL for this query.

## Example

```bash cURL theme={null}
curl "https://scrapebadger.com/v1/naver/local?query=강남+파스타" \
  -H "X-API-Key: YOUR_API_KEY"
```

```javascript Node.js theme={null}
const res = await fetch(
  "https://scrapebadger.com/v1/naver/local?" +
    new URLSearchParams({ query: "강남 파스타" }),
  { 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/local",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "강남 파스타"},
)
data = res.json()
```

```json Response theme={null}
{
  "query": "강남 파스타",
  "result_count": 10,
  "results": [
    {
      "place_id": "1234567890",
      "name": "트라토리아 강남",
      "category": "파스타",
      "address": "서울특별시 강남구 역삼동 123-45",
      "road_address": "서울특별시 강남구 테헤란로 12길 34",
      "phone": "02-555-1234",
      "rating": 4.6,
      "review_count": 1823,
      "is_open": true,
      "open_status_text": "영업 중 · 22:00에 영업 종료",
      "badges": ["예약", "포장"],
      "url": "https://map.naver.com/p/entry/place/1234567890",
      "rank": 1
    }
  ],
  "url": "https://map.naver.com/p/search/강남+파스타"
}
```


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