Naver

Get Naver place rank

Check where a Naver Place ranks in Naver Map for up to five keywords.

GET/v1/naver/places/{placeId}/rank
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
placeIdstringrequiredpath

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}$

queryarrayrequiredquery

Keywords to check, comma-separated, up to 5, e.g. `제주 족발,연동 맛집`.

depthintegeroptionalquery

How far down each list to look, 50 to 300 places.

≥ 50 · ≤ 300

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
18

Endpoint-specific response payload.

dataplaceId
string

The place id.

dataplaceName
stringnullable

The place's name, taken from a list it appears in; null when it ranks nowhere.

The search centre used.

datacoordinateslatitude
number

Latitude.

datacoordinateslongitude
number

Longitude.

One entry per keyword, in the order given.

datakeywords[]query
string

The keyword.

datakeywords[]status
string

`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

datakeywords[]rank
integernullable

The place's position in Naver Map's list, from 1; null when not ranked.

≥ 0

datakeywords[]total
integernullable

Places Naver Map lists for the keyword.

datakeywords[]scanned
integer

Places looked at.

≥ 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/places/1195271893/rank?query=제주%20족발" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Naver place rank by keyword.