Get Naver place rank
Check where a Naver Place ranks in Naver Map for up to five keywords.
Headers
Get your API keyAPI key (`sfk_...`)
The place id, as in `map.naver.com/p/entry/place/<id>` or `m.place.naver.com/restaurant/<id>`, e.g. `1195271893`. A place URL is accepted too.
pattern: ^\d{3,15}$
Keywords to check, comma-separated, up to 5, e.g. `제주 족발,연동 맛집`.
How far down each list to look, 50 to 300 places.
≥ 50 · ≤ 300
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 place id.
The place's name, taken from a list it appears in; null when it ranks nowhere.
The search centre used.
Latitude.
Longitude.
One entry per keyword, in the order given.
The keyword.
`ranked`: the place is in the list at `rank`. `not_ranked`: it is not in the first `scanned` places. `unavailable`: Naver did not answer for this keyword this time; the other keywords are complete.
one of: ranked, not_ranked, unavailable
The place's position in Naver Map's list, from 1; null when not ranked.
≥ 0
Places Naver Map lists for the keyword.
Places looked at.
≥ 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/places/1195271893/rank?query=제주%20족발" \
-H "x-api-key: YOUR_API_KEY"Responses
Naver place rank by keyword.