# Naver Maps Search API

> Search places on Naver Maps by keyword around a location, with name, category, rating, reviews, address, phone and booking options.

Source: https://www.sandbase.ai/apis/naver/maps
API reference: https://www.sandbase.ai/apis/naver/maps#api

## Facts

- Provider: Naver
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/naver/maps`
- Price: $0.01 per call
- Capabilities: api, naver, maps, local
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/naver/maps` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `query` | string | yes |  |
| `center` | string | no |  |
| `sort_by` | string | no | distance |
| `open_state` | string | no | now |
| `bookable` | string | no |  |
| `coupon` | string | no |  |
| `wheelchair_accessible` | string | no |  |
| `check_in_date` | string | no |  |
| `check_out_date` | string | no |  |
| `adults` | string | no |  |
| `children` | string | no |  |
| `page` | string | no |  |
| `json_restrictor` | string | no |  |

## FAQ

### How do I use the Naver Maps Search API?

Send a POST request to https://api.sandbase.ai/v1/api/naver/maps with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

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

$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Naver Maps Search API accept?

Required: query (string). Optional: center (string), sort_by (one of distance), open_state (one of now), bookable (string), coupon (string) and wheelchair_accessible (string) and 6 more. The Parameters table and the Playground on this page list every field.

### What does the Naver Maps Search API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Naver developer account or API key?

No. Naver Maps Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Naver API access separately.

## README

### Naver Maps Search

Search places on Naver Maps by keyword around a location, with name, category, rating, reviews, address, phone and booking options.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/naver/maps" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "카페"}'
```

The result is returned in `outputs[0].data` as structured JSON.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `query` | string | Yes | Parameter defines the query you want to search. You can use anything that you would use in a regular Naver Maps search. |
| `center` | string | No | Parameter defines the coordinates of the point in South Korea to search around, as `latitude,longitude` (e.g. `35.1796,129.0756` for Busan). The `distance` of each result is measured from this point. Naver Maps searches around Seoul City Ha |
| `sort_by` | string | No | Parameter defines the order of the results. By default, results come in the order of the Naver Maps list. Options: `distance` - Distance Lists of franchise branches, such as 스타벅스, are already sorted by distance, and mart lists keep their ow |
| `open_state` | string | No | Parameter defines the open state of the places. Options: `now` - Open now It applies to restaurants and cafes, hospitals, pharmacies, animal hospitals, gyms and other leisure places, and attractions such as parks. The other lists ignore it. |
| `bookable` | string | No | Parameter defines whether to only show places that can be booked on Naver. It can be set to `true` or `false` (default). Pharmacies, convenience stores, movie theaters, gas stations, franchise lists, and accommodations ignore it. Mart lists |
| `coupon` | string | No | Parameter defines whether to only show places with a coupon. It can be set to `true` or `false` (default). Hospitals, pharmacies, animal hospitals, convenience stores, movie theaters, gas stations, and franchise lists ignore it. |
| `wheelchair_accessible` | string | No | Parameter defines whether to only show places with a wheelchair accessible entrance. It can be set to `true` or `false` (default). Convenience stores, movie theaters, gas stations, and franchise lists ignore it. |
| `check_in_date` | string | No | Parameter defines the check-in date. The format is **YYYY-MM-DD** (e.g., `2026-12-12`). It must be used together with `check_out_date`. Dates apply to accommodation lists, such as 펜션, 캠핑장, and 글램핑. With dates, Naver Maps only returns the pl |
| `check_out_date` | string | No | Parameter defines the check-out date. The format is **YYYY-MM-DD** (e.g., `2026-12-14`). It must be used together with `check_in_date`, and be later than it. |
| `adults` | string | No | Parameter defines the number of adults. It's used together with `check_in_date` and `check_out_date`, and ignored without them. `adults` and `children` can add up to 15 guests, the most Naver Maps allows. |
| `children` | string | No | Parameter defines the number of children. It's used together with `check_in_date` and `check_out_date`, and ignored without them. Naver Maps has a single guest count, so children are added to adults: `adults=2` and `children=1` search for 3 |
| `page` | string | No | Value is used to get results on a specific page. (e.g., `1` (default) is the first page of results, `2` is the 2nd page of results, `3` is the 3rd page of results, etc.). Naver Maps returns up to 70 results per page, and up to 300 results ( |
| `json_restrictor` | string | No | Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details. |

#### Pricing

$0.010 per successful call. Failed calls are not charged.