Reviews
Naver에서 장소의 리뷰를 가져옵니다.
GET | POST /v1/naver/reviews파라미터는 GET의 쿼리 문자열로도, POST의 JSON 본문으로도 보낼 수 있습니다. 둘은 같습니다.
요청
curl "https://gateway.apinoa.com/v1/naver/reviews?place=1668757640&limit=5" \
-H "x-api-key: $APINOA_API_KEY"파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
cursor | string | The previous page's cursor. Pass it alone for the next page. | |
limit | integer 1–100 | Results wanted (default 10, at most 100). More than one page is charged per page. | |
place | string | The place's id, as places returns it. | |
sort | enum | Review order: Naver's recommended order (default) or newest first. relevant newest |
같은 파라미터와 모든 응답 타입은 OpenAPI 문서에도 있습니다.
응답
data에 PlaceReviewsPage를 돌려줍니다. 실제 응답을 줄인 것입니다. 배열은 앞쪽 항목만 남기고 긴 텍스트는 잘랐습니다.
{
"success": true,
"data": {
"engine": "naver",
"placeId": "1668757640",
"summary": {
"average": 4.93,
"count": 3373,
"distribution": {
"1": 0.1,
"2": 0.1,
"3": 0.19,
"4": 1.56,
"5": 89.69,
"0.5": 0.1,
"1.5": 0,
"2.5": 0.1,
"3.5": 0,
"4.5": 8.17
}
},
"starCounts": {"1": 1, "2": 1, "3": 2, "4": 16, "5": 922, "0.5": 1, "1.5": 0, "2.5": 1, "3.5": 0, "4.5": 84},
"sort": "relevant",
"page": {"index": 1, "size": 10, "total": 3196},
"reviews": [
{
"id": "6ad5f2011ddd71d9033b9ecc",
"rating": 5,
"body": "강남역 최애 카페 퍼스트커피랩 🥹🤍🤍 메뉴 하나하나 다 너무 맛있고 진짜 사장님 너무 천사 같이 친절하셔서 갈 때마다 너무 행복해요☺️ 바스크치즈케이크 진짜 식감 맛 다 예술이고 블루웨이브 티라미수 비주얼 너무 이뻐요.. 공간도 넓고 사진 찍을 곳도 많고 대화하기도 좋아요 ㅎㅎ🤍🤤 마들…",
"author": "1o24",
"authorId": "~1~_kHuOa82G3PPNPObGoskVg",
"authorUrl": "https://m.place.naver.com/my/5dff10568f87a842bc63ad7c/review?v=2",
"date": "2026-10-19",
"images": [
"https://pup-review-phinf.pstatic.net/MjAyNjEwMTlfMjcy/MDAxNzkyNDA2MDA4MDA3.J-TlhgD_PPK3cAAcuxSoIilWXIss8qdENpkTiYujJkIg.YTphIBdaNTCWWhQ-Qm4nHyLlK4wAne3FLQplAW3k…",
"https://pup-review-phinf.pstatic.net/MjAyNjEwMTlfNTAg/MDAxNzkyNDA2MDA3NjIy.znvSZCXRXziK0ft3wMUcLfFP0dzOlms0vG66a0CxNrUg.scQ5nMui-K35WCdKgO4t36xninZu108CzLtFbWkP…"
],
"reply": {
"body": "안녕하세요! 퍼스트커피랩 강남점을 이렇게 사랑해주셔서 정말 감사드려요 💖 메뉴마다 칭찬해주시니 기쁘네요~ 바스크치즈케이크의 풍미와 블루웨이브 티라미수의 아름다움까지 알아봐주셔서 뿌듯해요 😊 마들렌과 디저트들도 좋아해주셔서 더 열심히 준비해야겠어요! 넓은 공간에서 편안히 머물러주셔서 고맙…",
"date": "2026-10-19",
"author": "퍼스트커피랩 강남점"
},
"ext": {
"reviewId": "6ad5f2011ddd71d9033b9eed",
"visited": "10.19.월",
"visitCount": 2,
"views": 4360,
"keywords": ["커피가 맛있어요"],
"visit": [{"keywords": ["예약 없이 이용"]}],
"reactions": 0,
"reviewer": {"reviews": 1238, "photos": 1936, "followers": "37", "avgRating": 4.9},
"item": "딸기바스크",
"origin": "영수증",
"receipt": true
}
},
{
"id": "6ae1c72cd51bbeaa57e888ee",
"rating": 5,
"body": "말차바스트케익은 꼭 먹어야해요,, ㄷㄷ 진짜 입에서 말차 꾸덕함이 녹음,, 샤인머스켓 크로플도 바삭하고 휘낭시에도 신기한게많아여 ㅠㅡㅠ 브림브륄레 아인슈페너 마셧는데 달달하면서 고소한게 풍미가 가득합니당,, 인테리어도 너무 이쁘고 외국인 친구들도 조아할곳,, 부모님이랑 오기에도 너무 분…",
"author": "취미가리뷰하기",
"authorId": "~1~Han7x8zguEVEB5arpwKeKA",
"authorUrl": "https://m.place.naver.com/my/5f06da40848333b0d5c0909d/review?v=2",
"date": "2026-10-28",
"images": [
"https://pup-review-phinf.pstatic.net/MjAyNjEwMjhfMTcy/MDAxNzkzMTgxNDc1MTUw.fmEdZsNjMcs08nLkR2TGU-qp9MwOKOmN3BbAvKsZVLkg.AWLvp3vZ4vinF2lZlyxSnNpUu6Q4Ofw-9dximJw2…",
"https://pup-review-phinf.pstatic.net/MjAyNjEwMjhfMTkz/MDAxNzkzMTgxNDc1Nzc2.pOgr35bySsdawTRGPrIauEca9f92AiBrxUo3OVFXalEg.plOQJL_7azooMeIGBqN6WgagH8wYruzthaQeYIUP…"
],
"ext": {
"reviewId": "6ae1c72cd51bbeaa57e888fd",
"visited": "10.28.수",
"visitCount": 1,
"views": 499,
"keywords": ["디저트가 맛있어요"],
"visit": [{"keywords": ["예약 없이 이용"]}],
"reactions": 0,
"reviewer": {"reviews": 574, "photos": 2425, "followers": "60", "avgRating": 4.9},
"item": "크로아",
"origin": "영수증",
"receipt": true
}
}
],
"cursor": "70w3ND789lci5FNhDAX0y1ck7vAblyM3-FloIMWBrGJuij5dLjqRn0WYldmFKIOo3lkhrmOtA88OPlM3z1zMtQMXnDVPAILHzn-0Dw63u1j-twnSdY98L775bzVZt0vaHaWe7gJ8N0o2GPZSU6InxddThes5Z4JV…",
"fetchedAt": "2026-10-30T01:02:31.396Z"
}
}에러
| 상태 | 코드 | 의미 |
|---|---|---|
| 400 | INVALID_CURSOR | 이 오퍼레이션이 돌려준 cursor가 아닙니다. cursor 없이 처음부터 다시 호출하세요. |
| 400 | INVALID_PARAMS | 파라미터가 없거나, 알 수 없거나, 범위를 벗어났거나, 이 엔진이 받지 않는 값입니다. 메시지에 이름이 나옵니다. |
| 401 | UNAUTHORIZED | x-api-key 헤더가 없거나, 폐기되었거나 알 수 없는 키입니다. |
| 402 | INSUFFICIENT_BALANCE | 잔액이 이 호출 비용에 모자랍니다. 대시보드에서 충전하세요. |
| 404 | NOT_FOUND | 장소가 없습니다. |
| 429 | MARKETPLACE_SATURATED | 동시 호출이 너무 많습니다. Retry-After 초만큼 기다린 뒤 다시 시도하세요. |
| 502 | UPSTREAM_ERROR | 엔진이 쓸 수 없는 응답을 보냈습니다. 간격을 두고 다시 시도하세요. |
| 503 | SERVICE_UNAVAILABLE | 일시적인 장애입니다. 간격을 두고 다시 시도하세요. |
모든 코드는 Errors에 있습니다. 실패한 호출은 과금되지 않습니다.
가격
가격 호출당 $0.0012, 추가 호출마다 $0.0012 — 최대 9번 더, 합계 최대 $0.012. 정가 기준이며, 하루 1,000회를 넘으면 단가가 내려갑니다.
참고
places가 돌려준 장소의id를place로 넘깁니다.- Naver 방문자는 별점 대신 키워드를 남기는 경우가 많아 리뷰의
rating이 없을 수 있습니다.0으로 채우지 않습니다.