Places
Naver 지도에서 장소를 찾습니다.
GET | POST /v1/naver/places파라미터는 GET의 쿼리 문자열로도, POST의 JSON 본문으로도 보낼 수 있습니다. 둘은 같습니다.
요청
curl -G "https://gateway.apinoa.com/v1/naver/places" \
--data-urlencode "q=강남역 카페" \
--data-urlencode "limit=5" \
-H "x-api-key: $APINOA_API_KEY"파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
country | enum | The market, as an ISO 3166 country code. KR | |
cursor | string | The previous page's cursor. Pass it alone for the next page. | |
limit | integer 1–100 | Results wanted (default 20, at most 100). More than one page is charged per page. | |
location | string | Search as if from this point: lat,lng. | |
near | string | Search around this place name, or a lat,lng point. | |
q | string | The query, search operators included. | |
type | enum | The map's place list (the only one Naver has). maps |
같은 파라미터와 모든 응답 타입은 OpenAPI 문서에도 있습니다.
응답
data에 PlacesPage를 돌려줍니다. 실제 응답을 줄인 것입니다. 배열은 앞쪽 항목만 남기고 긴 텍스트는 잘랐습니다.
{
"success": true,
"data": {
"engine": "naver",
"query": "강남역 카페",
"outcome": "results",
"type": "maps",
"country": "KR",
"lang": "ko",
"places": [
{
"id": "1668757640",
"name": "퍼스트커피랩 강남점",
"url": "https://map.naver.com/p/entry/place/1668757640",
"address": {"full": "서울특별시 강남구 역삼동 618-18 1층", "street": "봉은사로6길 39 1층", "city": "서울 강남구 역삼동"},
"coordinates": {"lat": 37.5026235, "lng": 127.0279481},
"categories": ["카페"],
"rating": 4.93,
"reviewCount": 3373,
"phone": "0507-1315-7680",
"photos": ["https://ldb-phinf.pstatic.net/20261002_202/1790915466684GML4H_JPEG/%C7%D2%B7%CE%C0%A9_%C4%…"],
"attributes": [{"group": "편의", "label": "무선 인터넷"}],
"ext": {
"blogCafeReviewCount": 2137,
"imageCount": 94,
"businessCategory": "cafe",
"reviewPhotos": ["https://pup-review-phinf.pstatic.net/MjAyNjEwMjZfMTE0/MDAxNzkyOTk4ODEzOTIy.n8na_ZsNgteAeDy…"],
"microReview": "친절한 사장님과 함께하는 달콤한 시간",
"hoursNote": "11:00에 영업 시작",
"saves": "81,000+",
"insights": [{"title": "주간 인기 많은 메뉴", "text": "아메리카노, 딸기 크로아상, 디카페인 아메리카노, 카페라떼, 딸기바스크"}],
"coupons": [
{
"title": "새벽1시종료 신입생20%할인 쿠폰",
"type": "gift",
"image": "https://ldb-phinf.pstatic.net/20260312_152/1773277281515vs5i0_JPEG/KakaoTalk_20260311_1707…"
}
],
"reviewSnippets": ["크로플, 크루아상, 휘낭시에, 마들렌 등 디저트메뉴가 다양해서 좋아요!"],
"reviewPhotoAuthors": ["크리미2223"]
},
"statusText": "영업 전"
}
],
"ext": {
"ads": [
{
"id": "1785877248",
"name": "힉스커피",
"url": "https://map.naver.com/p/entry/place/1785877248",
"address": {"full": "강남대로110길 51 1층", "street": "강남대로110길 51 1층", "city": "서울 강남구 역삼동"},
"coordinates": {"lat": 37.5037312, "lng": 127.0291613},
"categories": ["카페"],
"rating": 4.88,
"reviewCount": 1515,
"phone": "0507-1344-5290",
"photos": ["https://searchad-phinf.pstatic.net/MjAyNjEwMjFfMjk2/MDAxNzkyNTUyODY0NDQ2.AsDZUIKK9k4BKet7r…"],
"attributes": [{"group": "편의", "label": "포장"}],
"ext": {
"blogCafeReviewCount": 854,
"imageCount": 9,
"businessCategory": "cafe",
"hasBooking": true,
"hasNaverPay": true,
"newOpening": false,
"talktalkUrl": "http://talk.naver.com/wi0qzcz?frm=pnmb",
"reviewPhotos": ["https://pup-review-phinf.pstatic.net/MjAyNjEwMDRfMTg0/MDAxNzkxMDgyMjU4Mjcy.Qsatj8LlE3aNz3H…"],
"microReview": "행성 모양 무스케이크의 달콤한 유혹",
"sponsored": true,
"adDescription": "과학커뮤니케이터의 디저트 맛집",
"adImages": ["https://searchad-phinf.pstatic.net/MjAyNjEwMjFfMjk2/MDAxNzkyNTUyODY0NDQ2.AsDZUIKK9k4BKet7r…"],
"hoursNote": "11:00에 영업 시작",
"saves": "29,000+",
"wheelchairEntrance": true,
"bookingUrl": "https://m.booking.naver.com/booking/6/bizes/1531167/search",
"order": ["pickup"],
"coupons": [
{
"title": "고소한 아메리카노 1잔 쿠폰",
"description": "알림받기한 고객님들께 드려요",
"type": "gift",
"image": "https://ldb-phinf.pstatic.net/20260926_146/1790407595573YnEoj_JPEG/%25C5%25B0%25BF%25C0%25…"
}
],
"reviewSnippets": ["무스케이크들 맛이 궁금해서왔다가 무한대소금빵 매력에 빠져서 재방문했어요! 커피와 잘어울려요"],
"reviewPhotoAuthors": ["김보경9358"],
"statusText": "영업 전"
}
}
]
},
"page": {"index": 1, "size": 5, "total": 1686},
"cursor": "5mlNx2SbRdB5gDNIsQsjjXQvu2ynVsYwV21_uEGpID7vPRmDaiDsAvXFXIbpJmijFCfcPL4JJ8dPJb2fDlzPXmZDn2…",
"fetchedAt": "2026-10-30T01:02:28.814Z"
}
}에러
| 상태 | 코드 | 의미 |
|---|---|---|
| 400 | INVALID_CURSOR | 이 오퍼레이션이 돌려준 cursor가 아닙니다. cursor 없이 처음부터 다시 호출하세요. |
| 400 | INVALID_PARAMS | 파라미터가 없거나, 알 수 없거나, 범위를 벗어났거나, 이 엔진이 받지 않는 값입니다. 메시지에 이름이 나옵니다. |
| 401 | UNAUTHORIZED | x-api-key 헤더가 없거나, 폐기되었거나 알 수 없는 키입니다. |
| 402 | INSUFFICIENT_BALANCE | 잔액이 이 호출 비용에 모자랍니다. 대시보드에서 충전하세요. |
| 429 | MARKETPLACE_SATURATED | 동시 호출이 너무 많습니다. Retry-After 초만큼 기다린 뒤 다시 시도하세요. |
| 502 | UPSTREAM_ERROR | 엔진이 쓸 수 없는 응답을 보냈습니다. 간격을 두고 다시 시도하세요. |
| 503 | SERVICE_UNAVAILABLE | 일시적인 장애입니다. 간격을 두고 다시 시도하세요. |
모든 코드는 Errors에 있습니다. 실패한 호출은 과금되지 않습니다.
가격
가격 호출당 $0.0012. 정가 기준이며, 하루 1,000회를 넘으면 단가가 내려갑니다.
참고
near로 장소 이름 주변을,location(lat,lng)으로 좌표 주변을 검색합니다.