Apinoa Docs

Reviews

从 Naver 获取地点的评论。

查看原始 .mdx
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"

参数

参数类型必填说明
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

这些参数及所有响应类型也写在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"
  }
}

错误

状态代码含义
400INVALID_CURSOR该 cursor 不是本操作返回的。请不带它重新开始。
400INVALID_PARAMS参数缺失、未知、超出范围,或该引擎不接受。消息中会指出是哪一个。
401UNAUTHORIZED缺少 x-api-key 请求头,或密钥已吊销或未知。
402INSUFFICIENT_BALANCE余额不足以支付本次调用。请在控制台充值。
404NOT_FOUND该地点不存在。
429MARKETPLACE_SATURATED并发调用过多。请等待 Retry-After 秒后重试。
502UPSTREAM_ERROR引擎返回了无法使用的内容。请退避后重试。
503SERVICE_UNAVAILABLE临时故障。请退避后重试。

全部错误代码见 Errors。失败的调用不计费。

价格

价格 每次调用 $0.0012,每多一次调用加 $0.0012——最多再加 9 次,合计最多 $0.012。标价;单日调用超过 1,000 次后单价下调。

说明

  • 把 places 返回的地点 id 作为 place 传入。
  • Naver 访客常留下关键词而非星级,因此评论的 rating 可能缺失,绝不会填为 0。

本页内容