Apinoa Docs

Reviews

Get a place's reviews from Naver.

View raw .mdx
GET | POST /v1/naver/reviews

Send parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.

Request

curl "https://gateway.apinoa.com/v1/naver/reviews?place=1668757640&limit=5" \
  -H "x-api-key: $APINOA_API_KEY"

Parameters

ParameterTypeRequiredNotes
cursorstringThe previous page's cursor. Pass it alone for the next page.
limitinteger 1–100Results wanted (default 10, at most 100). More than one page is charged per page.
placestringThe place's id, as places returns it.
sortenumReview order: Naver's recommended order (default) or newest first. relevant newest

The same parameters, and every response type, are in the OpenAPI document.

Response

Returns PlaceReviewsPage in data. A real response, shortened: arrays keep their first entries and long text is cut.

{
  "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

StatusCodeMeaning
400INVALID_CURSORThe cursor is not one this operation returned. Start again without it.
400INVALID_PARAMSA parameter is missing, unknown or out of range, or the engine does not take it. The message names it.
401UNAUTHORIZEDThe x-api-key header is missing, or the key is revoked or unknown.
402INSUFFICIENT_BALANCEThe balance does not cover this call. Top up in the dashboard.
404NOT_FOUNDThe place does not exist.
429MARKETPLACE_SATURATEDToo many concurrent calls. Retry after the Retry-After seconds.
502UPSTREAM_ERRORThe engine answered with something unusable. Retry with backoff.
503SERVICE_UNAVAILABLEA temporary failure. Retry with backoff.

Every code is listed in 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; 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.

On this page