Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Naver Map API page →
Reputation & Reviews

Naver Map API & Scraper

The Naver Map API returns Naver Place (Naver Map) South Korean local-business data as clean JSON.

7 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary place/search endpoint returns places with name, address, review count and, on most rows, a rating; you can run a broader search-all, pull a place/detail, reviews and blog-reviews, resolve a name to an id with its candidates and its exact-match flag, and autocomplete a query. It is built for Korean local-data products and review monitoring that need Naver data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.

Reference

What a Naver Place row contains, and which address is which

Korea runs two parallel address systems and Naver returns both on every place, which is the field pair most integrations mismatch. These are the fields measured on place/search-all rows for Korean business queries on 2026-08-26. Note what is not there: a search row carries review_count but no rating - the star rating lives on place/detail.

FieldWhat it holdsMeasured example
place_idNaver's numeric place id, as a string; length varies, no prefix"1943746521" and "33084820" were both live
road_addressdoro-myeong address - the post-2011 official street-name system서울특별시 강남구 강남대로 388
jibun_addressjibeon address - the legacy lot-number system, still used in records서울특별시 강남구 역삼동 825-13
short_addressthe abbreviated form Naver prints on a card서울 강남구 강남대로 388
category / category_idKorean category name plus its numeric id성형외과 with "223246"; 카페,디저트 for cafes
review_countinteger, the review count Naver shows for the place1408, 2055, 7791
has_bookingboolean - whether the place takes Naver reservationstrue / false
latitude / longitudeWGS84 decimal degrees, as numbers37.4974539 / 127.0284206
distance_kmfloat, distance from Naver's own map center for the queryHongdae cafes returned about 11 km on a Hongdae query

There is no rating field on a search row, so a missing rating is not an unrated business. limit sets the row count: place/search returns up to 50 places with data.total as Naver's real match count, and place/search-all up to 30.

Live example

Real request and response JSON

Captured from the indexed primary action, place/search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/naver-map/v1/place/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "강남 맛집",
    "limit": 5
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "naver-map",
    "endpoint": "place/search",
    "mode": "live",
    "latency_ms": 2901.9,
    "record_count": 5,
    "bytes": 605935,
    "cache_hit": false,
    "completeness_pct": 100,
    "surface": "ssr",
    "url": "https://pcmap.place.naver.com/restaurant/list?query=%EA%B0%95%EB%82%A8%20%EB%A7%9B%EC%A7%91&display=5",
    "completeness_basis": {
      "record_count": 5
    },
    "charged_credits": 1,
    "version": "1.0.0"
  },
  "data": {
    "places": [
      {
        "place_id": "1606942616",
        "name": "동어동락 삼성본점",
        "category": "생선회",
        "address": "삼성로96길 7 1층",
        "review_count": 5899,
        "rating": null,
        "image_url": "https://ldb-phinf.pstatic.net/20251020_84/1760890942296UYfP8_JPEG/%BF%DC%B0%FC.jpg",
        "longitude": 127.056447,
        "latitude": 37.5088156
      },
      {
        "place_id": "18485199",
        "name": "베이징덕 압구정 본점",
        "category": "중식당",
        "address": "논현로 874 1층",
        "review_count": 2381,
        "rating": 4.74,
        "image_url": "https://ldb-phinf.pstatic.net/20260813_145/1786607685375kEr5y_JPEG/%BA%A3%C0%CC%C2%A1%B4%F6_%B4%EB%C7%A5%BB%E7%C1%F8_1_%BF%DE%C2%CA.jpg",
        "longitude": 127.0288056,
        "latitude": 37.5265654
      },
      {
        "place_id": "1119605388",
        "name": "지노스 뉴욕 피자 압구정점",
        "category": "피자",
        "address": "선릉로161길 18 2층",
        "review_count": 1165,
        "rating": 4.7,
        "image_url": "https://ldb-phinf.pstatic.net/20230626_61/1687751929627JK7Bw_JPEG/%C1%F6%B3%EB%BD%BA%C7%C7%C0%DA_%B8%DE%C0%CE.jpg",
        "longitude": 127.039024,
        "latitude": 37.5274813
      }
    ],
    "total": 34396,
    "query": "강남 맛집"
  }
}
Actions

What the Naver Map API does

ActionDescriptionConcrete use caseKey params
place/searchsearch restaurants & food places by query (richest food data)Support teams call place/search to search restaurants & food places by query (richest food data).query, limit
place/search-allsearch ANY business type on Naver Place/Map (clinics, cafes, hotels, salons, shops…)Reputation platforms call place/search-all to search ANY business type on Naver Place/Map (clinics, cafes, hotels, salons, shops…).query, limit
place/detailfull place profile (rating, phone, hours, images)Market researchers call place/detail to get full place profile (rating, phone, hours, images).place_id, query
place/reviewsvisitor reviews (latest page, ~20 per call) with the true totalB2B review analysts call place/reviews to get visitor reviews (latest page, ~20 per call) with the true total.place_id, limit, page_size, sort, query
place/blog-reviewsblog reviewsSupport teams call place/blog-reviews to get blog reviews.place_id, limit, page_size, query
place/resolveresolve a query → place_id (works for food AND any other business)Reputation platforms call place/resolve to resolve a query → place_id (works for food AND any other business).query, place_id
search/autocompleteNaver search-box keyword suggestions for a partial term (keyword research)Market researchers call search/autocomplete to get naver search-box keyword suggestions for a partial term (keyword research).query, limit
Code samples

Call place/search from your stack

curl -X POST https://api.reefapi.com/naver-map/v1/place/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"강남 맛집","limit":5}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.naver-map.place/search with {"query":"강남 맛집","limit":5}.
Use cases

Who uses this API and why

  • Local apps call place/search to list Korean businesses by area.
  • Reputation tools use place/reviews and place/blog-reviews to monitor sentiment.
  • Lead-gen uses place/search-all to build local business lists.
FAQ

Questions developers ask before integrating

Should I call place/search or place/search-all?

place/search-all, unless you specifically want restaurants. place/search is the food-oriented surface and carries the richest restaurant fields; place/search-all covers every business type - clinics, cafes, hotels, salons, shops - and is the one that returns place_id, category_id, both addresses and coordinates on a single row. A measured call for 강남 성형외과 (Gangnam plastic surgery) returned five clinics with full profiles.

How many results can one call return?

place/search takes limit from 1 to 50 and returns up to that many places from the list Naver's map shows, with data.total as the full number of matches. place/search-all takes up to 30: the first 10 come from Naver's search-box suggestions and the rest from the map's full result list, with no place repeated. To reach more than that, narrow the query - by district, by neighborhood, by category word.

What is a Naver place_id and where else can I use it?

It is the numeric id in Naver's own place URLs (map.naver.com/p/entry/place/<id>, place.naver.com/restaurant/<id>), returned as a string. Length is not fixed: 33084820 (8 digits) and 1943746521 (10 digits) appeared in the same result set, so do not validate by length. If all you have is a name, place/resolve turns it into a place_id and shows its work: a measured call on 강남 맛집 returned id 1427134948 with the place's name, category, road address and 9,038 reviews beside it, exact_name_match false because a category phrase is not a shop name, and the six runners-up it passed over. Read exact_name_match before you trust the id.

Why are there two addresses on every place?

Korea moved from lot-number addressing (jibeon) to street-name addressing (doro-myeong) in 2011, and both remain in daily use, so Naver carries both. road_address is the official current form and the one to use for mail and geocoding; jibun_address is what older records, land registries and many locals still use. short_address is neither - it is the display abbreviation, with 서울특별시 shortened to 서울. All three describe the same building.

What are place_suggestions?

Naver's own related-query list for the search you ran, returned alongside the places as plain strings. A measured call for 강남 성형외과 returned ["강남역성형외과"], and one for 홍대 카페 returned nine, including 홍대 만화카페 and 홍대 고양이카페. Because the row ceiling is 10, these are the practical way to widen coverage: feed each suggestion back as a fresh query.

Do I have to search in Korean?

For places, in practice yes. The queries that returned data were Korean text - a business name, or an area plus a business word, like 강남 성형외과 or 홍대 카페 - because that is how the listings themselves are written. Names, categories and addresses all come back in Hangul with no romanized variants, so plan for UTF-8 end to end and for a transliteration step if your users read Latin script. search/autocomplete takes a partial term and returns Naver's own completions - 아이폰 returned 아이폰18, 아이폰17 and 아이폰17프로 - which is the cheapest way to learn the exact wording Korean users type.

What does a TARGET_BLOCKED response mean here?

It means Naver answered that attempt with a challenge instead of data, and it comes back with retryable set to true. It is a transient condition rather than a verdict on your parameters, so there is nothing to fix on your side beyond retrying later or spacing calls out. Handle it the way you would a 503: catch the code, back off, and never read the absence of data as "this place does not exist".

How does this engine handle a bad parameter?

limit is parsed strictly - a non-numeric limit returns PARSE_ERROR with retryable false rather than being ignored - while query is required and rejected when empty. There is no page parameter on any place action, so pagination is not the shape of this engine. You widen coverage by issuing more queries, not by walking pages.

What is the Naver Map API?

Naver Map API is a ReefAPI endpoint group for naver map / naver place: korean business listings, reviews and ratings. It returns live JSON through POST requests under /naver-map/v1.

Is the Naver Map API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Naver Map calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Naver Map login or account?

No login to Naver Map is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Naver Map data?

The page example is captured from a live place/search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Naver Map API use?

Naver Map actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Naver Map from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call naver-map actions with the same key, credit pool and JSON envelope used by normal REST requests.

Questions developers ask about Naver Map data

From Stack Overflow, Reddit and search, answered with live calls on 2 Nov 2026.

How do I get Naver Map results for a keyword like 강남역 맛집 (name, rating, review count) without Selenium?▾

Developers scraping Naver Map with Selenium report switching into the searchIframe for the result list and the entryIframe for each place, waiting several seconds per click, and rewriting selectors every time Naver changes the layout.

ReefAPI's Naver API takes the same Korean keyword and returns the Naver Map restaurant list in Naver's order: each place with its place_id, category, address, coordinates, visitor review_count and star rating (null when Naver shows no score for that place), plus the total number of matches.

curl · place/search
curl -X POST https://api.reefapi.com/naver/v1/place/search \
  -H "x-api-key: $REEF_KEY" -H "content-type: application/json" \
  -d '{"query":"강남역 맛집","limit":3}'

Real response, 3 Nov 2026: total 7004 · 1. "닭갈비전 강남점" 닭갈비, rating 4.88, 1,839 reviews · 2. "멕시타이거" 요리주점, rating 4.85, 1,404 reviews · 3. "퀸즈가든 강남역점" 샤브샤브, rating 4.91, 7,816 reviews

Naver's local search API returns at most 5 places and no ratings. How do I get more Naver Place results?▾

Naver's documentation for the local search API (/v1/search/local) caps display at 5 and start at 1, so a query never pages past the first five places, and each item carries a name, category, address and map coordinates but no rating, review count or place ID. The Search API is also limited to 25,000 calls a day.

For Naver Place data on any kind of business (cafes, clinics, salons, hotels), ReefAPI's Naver API place/search-all returns each match with its Naver Place ID, road and lot-number address, visitor review count, a booking flag and latitude/longitude.

curl · place/search-all
curl -X POST https://api.reefapi.com/naver/v1/place/search-all \
  -H "x-api-key: $REEF_KEY" -H "content-type: application/json" \
  -d '{"query":"성수동 카페","limit":10}'

Real response, 2 Nov 2026: 10 places · "베통 성수" 카페,디저트, 5,625 reviews · "도토리오븐" 4,366 reviews · "성수동대림창고갤러리" 3,961 reviews at 37.5417036, 127.0563952

How do I find the Naver Place ID for one specific store or branch?▾

The Naver Place ID is the number in a place link such as m.place.naver.com/place/1086067689, and review and detail lookups need it; developers report that the official local search API does not return it.

ReefAPI's Naver API place/resolve turns a store name into that ID, says whether the name matched exactly (exact_name_match), and lists the runner-up places as candidates, so one branch of a chain is not confused with another.

curl · place/resolve
curl -X POST https://api.reefapi.com/naver/v1/place/resolve \
  -H "x-api-key: $REEF_KEY" -H "content-type: application/json" \
  -d '{"query":"스타벅스 강남R점"}'

Real response, 2 Nov 2026: place_id 1086067689 · "스타벅스 강남R점" · 강남대로 390 (역삼동) · 8,265 reviews · exact_name_match true · candidates "스타벅스 압구정R점" 1072718391, "스타벅스 청담스타R점" 487040518

How can I scrape Naver Place visitor reviews (방문자 리뷰)?▾

Naver's Search API documents no review fields, so developers who need Naver Place visitor reviews end up opening each place in a browser and reading the review tab inside the entryIframe.

ReefAPI's Naver API place/reviews takes a place ID and returns the latest page of visitor reviews (about 20): star rating, review text, visit date, posting date, author nickname, photos and the owner's reply, together with the place's real review total and its star distribution.

curl · place/reviews
curl -X POST https://api.reefapi.com/naver/v1/place/reviews \
  -H "x-api-key: $REEF_KEY" -H "content-type: application/json" \
  -d '{"place_id":"18485191","limit":5}'

Real response, 2 Nov 2026: "강남돌곱창" · total_reported 516 · rating 5 · "강남돌곱창에서만 5년이 넘었네요^^ 곱창도 쫄깃하고 신선하게 맛있어서…" · visited 8.13.목 · created 8.19.수 · 5 photos

How do I get a Naver Place's phone number, opening hours and blog review count?▾

On Naver Map the full address, hours and phone only appear after you click a result, which is why developers on Inflearn describe crawling store details one click at a time.

ReefAPI's Naver API place/detail returns that panel for a place ID: road and lot-number address, phone, star rating, visitor and blog review counts, opening hours for each weekday, amenities, photos and the dishes reviewers mention most. To read the blog posts themselves, place/blog-reviews returns each post's title and link.

curl · place/detail
curl -X POST https://api.reefapi.com/naver/v1/place/detail \
  -H "x-api-key: $REEF_KEY" -H "content-type: application/json" \
  -d '{"place_id":"18485191"}'

Real response, 2 Nov 2026: "강남돌곱창" · 02-548-7225 · rating 4.76 · 516 visitor / 256 blog reviews · Tue 15:00–23:30 · Sun "정기휴무 (매주 일요일)" · amenities include 주차, 발렛파킹

How do I collect Naver autocomplete keywords for Korean keyword research?▾

Korean marketers and developers build small Python tools that pull the keywords Naver suggests under its search box and save them to Excel, as a starting list for Korean keyword research.

ReefAPI's Naver API search/autocomplete returns those suggestions for a partial Korean or English term. They are the phrases Naver suggests, in Naver's order, not search volumes.

python
import requests

r = requests.post(
    "https://api.reefapi.com/naver/v1/search/autocomplete",
    headers={"x-api-key": REEF_KEY},
    json={"query": "아이폰", "limit": 10},
)
for s in r.json()["data"]["suggestions"]:
    print(s["suggestion"])

Real response, 2 Nov 2026: "아이폰" → 아이폰 듀오 · 아이폰 18프로 · 아이폰18 · 아이폰17 · 아이폰 폴더블 · 아이폰17프로 · 아이폰 se

docs / naver-map

Naver Map

Naver Map / Naver Place: Korean business listings, reviews and ratings.

base /naver-map/v17 endpoints
post/naver-map/v1/place/search1 credit

search restaurants & food places by query (richest food data)

ParameterAllowed / rangeDescription
queryrequired—Korean search text (e.g. a business name or 'area + cuisine'). Used to find places, or to resolve a place_id when one isn't given.
limit = 10optional1–Maximum number of places to return (1-50).
Try in playground →
post/naver-map/v1/place/search-all1 credit

search ANY business type on Naver Place/Map (clinics, cafes, hotels, salons, shops…)

ParameterAllowed / rangeDescription
queryrequired—Korean search text for ANY business type — clinic, cafe, hotel, salon, shop, hospital, etc. (e.g. '강남 성형외과' = Gangnam plastic surgery).
limit = 10optional1–Maximum number of places to return (1-30). The first 10 come from Naver's search-box results; above 10 the rest is filled from the Naver Map result list.
Try in playground →
post/naver-map/v1/place/detail1 credit

full place profile (rating, phone, hours, images)

ParameterAllowed / rangeDescription
place_idrequired—Naver Place numeric id (from place/search results or place/resolve).
queryoptional—Korean search text (e.g. a business name or 'area + cuisine'). Used to find places, or to resolve a place_id when one isn't given.
Try in playground →
post/naver-map/v1/place/reviews1 credit

visitor reviews (latest page, ~20 per call) with the true total

ParameterAllowed / rangeDescription
place_idrequired—Naver Place numeric id (from place/search results or place/resolve).
limit = 50optional1–Maximum reviews to collect (capped by Naver).
page_size = 20optional1–50Accepted for compatibility but currently has no effect — reviews come from one page. meta.page_size_supported reports this.
sort = recentoptionalrecent · RECENT · RECOMMEND · RATINGAccepted for compatibility but currently has no effect — reviews arrive in Naver's own page order. meta.sort_supported reports this.
queryoptional—Korean search text (e.g. a business name or 'area + cuisine'). Used to find places, or to resolve a place_id when one isn't given.
Try in playground →
post/naver-map/v1/place/blog-reviews1 credit

blog reviews

ParameterAllowed / rangeDescription
place_idrequired—Naver Place numeric id (from place/search results or place/resolve).
limit = 50optional1–Maximum blog reviews to collect.
page_size = 20optional1–50Accepted for compatibility but currently has no effect — reviews come from one page. meta.page_size_supported reports this.
queryoptional—Korean search text (e.g. a business name or 'area + cuisine'). Used to find places, or to resolve a place_id when one isn't given.
Try in playground →
post/naver-map/v1/place/resolve1 credit

resolve a query → place_id (works for food AND any other business)

ParameterAllowed / rangeDescription
queryrequired—Korean search text (e.g. a business name or 'area + cuisine'). Used to find places, or to resolve a place_id when one isn't given.
place_idoptional—Naver Place numeric id (from place/search results or place/resolve).
Try in playground →
post/naver-map/v1/search/autocomplete1 credit

Naver search-box keyword suggestions for a partial term (keyword research)

ParameterAllowed / rangeDescription
queryrequired—Partial Korean (or English) search term to autocomplete (e.g. '아이폰' → '아이폰17', '아이폰18'…).
limit = 10optional1–Maximum number of suggestions to return (1-30).
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.