querystringrequired
Parameter defines the query you want to search. You can use anything that you would use in a regular Naver Maps search.
Naver Maps Search
https://api.sandbase.ai/v1/api/naver/mapsSearch places on Naver Maps by keyword around a location, with name, category, rating, reviews, address, phone and booking options.
- Price
- $0.01USD / call
- Method
- POST
- Response
- JSON
- Parameters
- 1 required · 12 optional
Playground
Input
Parameter defines the query you want to search. You can use anything that you would use in a regular Naver Maps search.
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 Hall when it's not set.
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 own order.
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.
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 return no places with it.
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.
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.
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 places available for the stay, and `price` is the average nightly price.
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.
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.
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 guests, like `adults=3`. `adults` and `children` can add up to 15 guests, the most Naver Maps allows.
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 (5 pages).
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.
OutputReady
Your output will appear here
Complete the inputs, then click Run.
API 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
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.
Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/naver/maps" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"query": "카페"
}
SANDBASE_JSON
)
printf '%s\n' "$result"2. Authentication
Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
3. Parameters
centerstring
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 Hall when it's not set.
sort_bystring
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 own order.
Possible values: distance
open_statestring
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.
Possible values: now
bookablestring
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 return no places with it.
couponstring
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_accessiblestring
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_datestring
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 places available for the stay, and `price` is the average nightly price.
check_out_datestring
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.
adultsstring
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.
childrenstring
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 guests, like `adults=3`. `adults` and `children` can add up to 15 guests, the most Naver Maps allows.
pagestring
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 (5 pages).
json_restrictorstring
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.
4. Response
Saved example response for this API; no live request is made when viewing it.
No saved response has been published. Run the API in Playground to inspect its response.
Explore more
Related APIs
| API | Price | Response |
|---|---|---|
Naver Maps SearchThis API Naver | $0.01 per call | JSON |
Naver | $0.01 per call | JSON |
Naver | $0.015 per call | JSON |
Naver | From $0.032 per call | JSON |
Naver | $0.01 per call | JSON |
Questions
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.