--- title: "Reviews" description: "Get a place's reviews from Naver." --- > Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/serp/llms.txt) ```http GET | POST /v1/naver/reviews ``` Send parameters as a query string with `GET`, or as a JSON body with `POST`. Both are equivalent. ## Request ```bash tab="cURL" curl "https://gateway.apinoa.com/v1/naver/reviews?place=1668757640&limit=5" \ -H "x-api-key: $APINOA_API_KEY" ``` ```js tab="JavaScript" const params = new URLSearchParams({ place: "1668757640", limit: "5" }); const res = await fetch(`https://gateway.apinoa.com/v1/naver/reviews?${params}`, { headers: { "x-api-key": process.env.APINOA_API_KEY }, }); const { success, data, error } = await res.json(); ``` ```python tab="Python" import os import requests res = requests.get( "https://gateway.apinoa.com/v1/naver/reviews", params={"place": "1668757640", "limit": "5"}, headers={"x-api-key": os.environ["APINOA_API_KEY"]}, ) body = res.json() ``` ## Parameters | Parameter | Type | Required | Notes | |---|---|---|---| | `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` | The same parameters, and every response type, are in the OpenAPI document: https://apinoa.com/openapi.json ## Response Returns [`PlaceReviewsPage`](/docs/api-reference/serp/response-schema#placereviewspage) in `data`. A real response, shortened: arrays keep their first entries and long text is cut. ```json { "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" } } ``` ## Errors | Status | Code | Meaning | |---|---|---| | 400 | `INVALID_CURSOR` | The `cursor` is not one this operation returned. Start again without it. | | 400 | `INVALID_PARAMS` | A parameter is missing, unknown or out of range, or the engine does not take it. The message names it. | | 401 | `UNAUTHORIZED` | The `x-api-key` header is missing, or the key is revoked or unknown. | | 402 | `INSUFFICIENT_BALANCE` | The balance does not cover this call. Top up in the dashboard. | | 404 | `NOT_FOUND` | The place does not exist. | | 429 | `MARKETPLACE_SATURATED` | Too many concurrent calls. Retry after the `Retry-After` seconds. | | 502 | `UPSTREAM_ERROR` | The engine answered with something unusable. Retry with backoff. | | 503 | `SERVICE_UNAVAILABLE` | A temporary failure. Retry with backoff. | Every code is listed in [Errors](/docs/errors). Failed calls are not billed. ## Pricing **Price** $0.0012 per call, plus $0.0012 for each extra call it makes — at most 9 more, so $0.012 in total. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day. ## Notes - Pass the place's `id` from `places` as `place`. - Naver visitors often leave keywords instead of stars, so a review's `rating` may be absent. It is never `0`.