Search Korean businesses on Naver and read their reviews
The Naver Map API returns Naver Place (Naver Map) South Korean local-business data as clean JSON.
- median response
- 3s
- endpoints
- 7
- credit per call
- 1
1 credit per call≈ $1/1,000 calls1,000 free credits, no card
- 스타벅스 강남교보타워R점rating4.49
- category
- 카페
- address
- 강남대로 465 (서초동)
- 스타벅스 강남R점rating4.51
- category
- 카페
- address
- 강남대로 390 (역삼동)
- 스타벅스 케이스퀘어강남점rating4.67
- category
- 카페
- address
- 강남대로94길 10 (역삼동)
7 active endpoints. Every call is 1 credit.
- POST/naver-map/v1/place/search1 credit
- POST/naver-map/v1/place/search-all1 credit
- POST/naver-map/v1/place/detail1 credit
- POST/naver-map/v1/place/reviews1 credit
- POST/naver-map/v1/place/blog-reviews1 credit
- POST/naver-map/v1/place/resolve1 credit
- POST/naver-map/v1/search/autocomplete1 credit
Run the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
Naver Map API
4 of 7 endpoints, ready to run
Find Korean businesses by name, brand or category — in English or in Korean — and get each one's place id, category, address, review count, coordinates and rating.
{ "ok": true, "meta": { "api": "naver-map", "endpoint": "place/search", "mode": "live", "latency_ms": 3040.1, "record_count": 10, "cache_hit": false, "completeness_pct": 100 }, "data": { "places": [ { "place_id": "1080585723", "name": "스타벅스 강남교보타워R점", "category": "카페", "address": "강남대로 465 (서초동)", "review_count": 5365, "rating": 4.49, "image_url": "https://ldb-phinf.pstatic.net/20190828_93/1566953601239OT9MQ_PNG/xX7Wv642gXMoTI0DAv0hRymS.png", "longitude": 127.0243352, "latitude": 37.5037107 }, { "place_id": "1086067689", "name": "스타벅스 강남R점", "category": "카페", "address": "강남대로 390 (역삼동)", "review_count": 8258, "rating": 4.51, "image_url": "https://ldb-phinf.pstatic.net/20190828_93/1566953601239OT9MQ_PNG/xX7Wv642gXMoTI0DAv0hRymS.png", "longitude": 127.028439, "latitude": 37.497711 }, { "place_id": "1140751329", "name": "스타벅스 케이스퀘어강남점", "category": "카페", "address": "강남대로94길 10 (역삼동)", "review_count": 118, "rating": 4.67, "image_url": "https://ldb-phinf.pstatic.net/20190828_93/1566953601239OT9MQ_PNG/xX7Wv642gXMoTI0DAv0hRymS.png", "longitude": 127.0282043, "latitude": 37.4991914 } ], "total": 117, "query": "starbucks gangnam" } }
What Naver Map endpoints does ReefAPI ship?
7 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Every parameter, every allowed value →
Missing a Naver Map endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Naver Map API works
Naver Map is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 746 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
Resolve the name, check the flag, then read
A shop name goes in and a Naver Map place id comes out, but the id is not the whole answer — what makes it usable is that the response says what it picked and what it passed over. Code written against the engine's old name, POST /naver/v1/..., keeps working unchanged.
{"query": "<the shop name>"}One id, and beside it the name, category, road address and review count of the place it chose, an exact_name_match flag, and the candidates it rejected with the same fields on each.
True means the registered name matched your query character for character and you can go straight on. False means it fell back to a looser match — the branch you wanted is usually sitting in candidates, so pick the id there rather than accepting the top one.
{"place_id": "1086067689", "limit": 20}The star distribution for the whole business, plus the most recent page of visitor reviews. place/detail adds the phone, both address forms and the opening schedule.
Two credits from a shop name to its review shape, with the evidence for the match in the same response. Repeat only the last call to track sentiment; the resolve is needed once per place.
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}'{
"ok": true,
"data": { … },
"meta": {
"api": "naver-map",
"endpoint": "place/search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}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.
| Field | What it holds | Measured example |
|---|---|---|
| place_id | Naver's numeric place id, as a string; length varies, no prefix | "1943746521" and "33084820" were both live |
| road_address | doro-myeong address - the post-2011 official street-name system | 서울특별시 강남구 강남대로 388 |
| jibun_address | jibeon address - the legacy lot-number system, still used in records | 서울특별시 강남구 역삼동 825-13 |
| short_address | the abbreviated form Naver prints on a card | 서울 강남구 강남대로 388 |
| category / category_id | Korean category name plus its numeric id | 성형외과 with "223246"; 카페,디저트 for cafes |
| review_count | integer, the review count Naver shows for the place | 1408, 2055, 7791 |
| has_booking | boolean - whether the place takes Naver reservations | true / false |
| latitude / longitude | WGS84 decimal degrees, as numbers | 37.4974539 / 127.0284206 |
| distance_km | float, distance from Naver's own map center for the query | Hongdae 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.
Did it find the right shop, and how many reviews really come back
Measured across six queries in English and Korean and two Seoul coffee shops, and re-measured after the resolve action was rewritten. Four of these rows go against us and they are the ones worth reading first.
place/resolve no longer hands back a bare number. Asked for the exact Korean name of the Gangnam R branch it returned that branch — id, name, cafe category, road address, 8,258 reviews — with exact_name_match true and the five runners-up it rejected, each with the same fields. Asked the same thing in English it picked a different Gangnam Starbucks and said so: exact_name_match false, with the branch we actually meant sitting first in candidates. Read the flag rather than the id, and the wrong-shop failure becomes visible in the response instead of downstream.
You do not need Korean to use this. 'starbucks gangnam', 'hongdae cafe' and 'myeongdong hotel' all returned the right Korean businesses, with Korean names and addresses in the rows. What thins out is not the language, it is the CATEGORY: place/search leans food and drink, while place/search-all covers every business type. Use place/search-all for anything that is not a restaurant or a cafe.
On place/search the rating field is filled on some rows and empty on others, and how many varies by query. On place/search-all it was filled 0 of 40 across four queries — that surface carries no rating at all, in exchange for the wider category coverage and a richer address block. The review count was filled every time on both. Size a business by its review count, and take the rating from place/detail, where the whole star distribution comes with it.
A shop reporting 8,258 visitor reviews returned exactly 20 rows whether we asked for 20, 100 or 200, with capped true in the response. A second shop reporting 3,435 did the same. The sort and page-size parameters are accepted and documented as having no effect. What you get instead is the complete star distribution — ten buckets from 0.5 to 5.0 — which is the shape of all of them.
On two shops, 20 rows each, the body was filled 10 of 20 and 9 of 20. A Naver visitor review can be a rating and a photo with nothing written. Read the dates carefully too: they arrive in Korean short form as month, day and weekday, with no year in them.
The blog-review endpoint reports the real total and then tells you what it can reach: on a shop with 1,047 blog posts it returned fetchable_max 113 and handed back 10 rows per call. Those rows are titles and links to Korean blogs and community boards, not review text.
What people build with Naver Map
The jobs this data is most often used for.
endpoints
credit per call
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.
What Naver Map data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 746 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
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}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/naver-map/v1/place/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "강남 맛집",
"limit": 5
},
timeout=90,
)
print(r.json()["data"])Questions developers ask about Naver Map data
Collected from Stack Overflow, Reddit and search, and 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 -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 -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 -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 -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 -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.
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
Have a question? We got answers.
The questions people actually ask before wiring up Naver Map.
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.
19 Reputation & Reviews APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Naver Map, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 745 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-08-28.