Naver

Search Naver Map places

Search Naver Map places by keyword, in Naver's own order, up to 300 places deep.

GET/v1/naver/search/places
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
querystringrequiredquery

Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed.

min 1 chars · max 200 chars

pageintegeroptionalquery

Page number, from 1.

≥ 1 · ≤ 300

limitintegeroptionalquery

Places per page, 1 to 50.

≥ 1 · ≤ 50

latitudenumberoptionalquery

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

longitudenumberoptionalquery

Longitude of the map centre, inside South Korea. Default: Seoul City Hall (126.9783882).

≥ 124 · ≤ 132

Response fields
39

Endpoint-specific response payload.

dataquery
string

The search words, as sent.

datatotal
integernullable

Places Naver Map says match; it lists at most 300 of them.

Places, in Naver Map's order.

dataplaces[]rank
integer

Position in Naver Map's list, from 1.

≥ 0

dataplaces[]id
string

Place id.

dataplaces[]name
string

Place name.

dataplaces[]category
stringnullable

Category, e.g. `한식` or `피부과`.

dataplaces[]businessType
stringnullable

Naver's business type, e.g. `restaurant`, `hospital`, `place`.

dataplaces[]address
stringnullable

Lot-number address (지번).

dataplaces[]roadAddress
stringnullable

Road-name address (도로명).

dataplaces[]fullAddress
stringnullable

Full road address with the city.

dataplaces[]phone
stringnullable

Phone number.

dataplaces[]virtualPhone
stringnullable

Naver's forwarding number (`0507-...`), when the place uses one.

Where the place is.

dataplaces[]coordinateslatitude
number

Latitude.

dataplaces[]coordinateslongitude
number

Longitude.

dataplaces[]distance
stringnullable

Distance from the search centre as Naver prints it, e.g. `1.2km`.

dataplaces[]imageUrl
stringnullable

Main photo.

dataplaces[]imageCount
integernullable

Photos of the place.

dataplaces[]rating
numbernullable

Average visitor rating out of 5.

dataplaces[]visitorReviewCount
integernullable

Visitor reviews.

dataplaces[]blogReviewCount
integernullable

Blog and cafe reviews that link the place.

dataplaces[]bookingUrl
stringnullable

Naver Booking page, when the place takes bookings.

dataplaces[]hasBooking
booleannullable

Whether the place takes Naver bookings.

dataplaces[]isDelivery
booleannullable

Whether it delivers.

dataplaces[]isTakeOut
booleannullable

Whether it does take-away.

dataplaces[]isNewOpening
boolean

Whether Naver marks it as newly opened.

dataplaces[]url
string

The place on Naver Map.

Pagination state for the current page.

datapagepage
integer

Current page number (1-based).

≥ 0

datapagehasMore
boolean

Whether another page is available.

datapagenextPage
integernullable

Next page number when more pages exist; null on the last page.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.