Search Naver Map places
Search Naver Map places by keyword, in Naver's own order, up to 300 places deep.
Headers
Get your API keyAPI key (`sfk_...`)
Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed.
min 1 chars · max 200 chars
Page number, from 1.
≥ 1 · ≤ 300
Places per page, 1 to 50.
≥ 1 · ≤ 50
Latitude of the map centre the search is run from, inside South Korea. Default: Seoul City Hall (37.5666103). Naver Map ranks places partly by distance from it.
≥ 33 · ≤ 39
Longitude of the map centre, inside South Korea. Default: Seoul City Hall (126.9783882).
≥ 124 · ≤ 132
Endpoint-specific response payload.
The search words, as sent.
Places Naver Map says match; it lists at most 300 of them.
Places, in Naver Map's order.
Position in Naver Map's list, from 1.
≥ 0
Place id.
Place name.
Category, e.g. `한식` or `피부과`.
Naver's business type, e.g. `restaurant`, `hospital`, `place`.
Lot-number address (지번).
Road-name address (도로명).
Full road address with the city.
Phone number.
Naver's forwarding number (`0507-...`), when the place uses one.
Where the place is.
Latitude.
Longitude.
Distance from the search centre as Naver prints it, e.g. `1.2km`.
Main photo.
Photos of the place.
Average visitor rating out of 5.
Visitor reviews.
Blog and cafe reviews that link the place.
Naver Booking page, when the place takes bookings.
Whether the place takes Naver bookings.
Whether it delivers.
Whether it does take-away.
Whether Naver marks it as newly opened.
The place on Naver Map.
Pagination state for the current page.
Current page number (1-based).
≥ 0
Whether another page is available.
Next page number when more pages exist; null on the last page.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/naver/search/places?query=강남역%20맛집" \
-H "x-api-key: YOUR_API_KEY"Responses
Naver Map place search results.