Lemong Partner API

Appearance

고객 불만족 요인 분석 조회 ​

브랜드 리뷰를 긍정과 부정으로 나눠 카테고리 순위와 자주 나온 키워드를 반환합니다. 댓글몽 BIZ의 브랜드 리뷰 현황 내 고객 불만족 요인 분석 데이터와 같은 데이터를 반환합니다.

GET /partner/v1/brands/{brand_code}/review-insights

Request ​

bash
curl -H 'x-partner-api-key: YOUR_API_KEY' \
  'https://api.lemong.ai/partner/v1/brands/BRAND100/review-insights?from=2026-10-01&to=2026-10-27'

쿼리 파라미터 ​

파라미터필수 여부타입설명
fromoptionalYYYY-MM-DD집계 시작일 (KST, 포함) - 생략 시 to 기준 30일 전
tooptionalYYYY-MM-DD집계 종료일 (KST, 포함) - 생략 시 오늘
platformoptionalenumBAEMIN, YOGIYO, CPEATS
user_codeoptionalstring점주 목록 조회의 user_code

Response ​

json
{
  "status": "SUCCESS",
  "status_code": 200,
  "message": "OK",
  "data": {
    "from": "2026-10-01",
    "to": "2026-10-27",
    "analyzed_through": "2026-10-27",
    "sentiments": [
      {
        "sentiment": "NEGATIVE",
        "total_review_count": 128,
        "categories": [
          {
            "category": "TASTE",
            "label": "맛",
            "review_count": 61,
            "ratio": 47.7
          },
          {
            "category": "DELIVERY_PACKAGING",
            "label": "배달/포장",
            "review_count": 34,
            "ratio": 26.6
          },
          {
            "category": "QUANTITY",
            "label": "양",
            "review_count": 22,
            "ratio": 17.2
          },
          {
            "category": "SERVICE",
            "label": "서비스/응대",
            "review_count": 9,
            "ratio": 7
          },
          {
            "category": "FRESHNESS_HYGIENE",
            "label": "신선/위생",
            "review_count": 4,
            "ratio": 3.1
          },
          {
            "category": "MENU_COMPOSITION",
            "label": "메뉴/구성",
            "review_count": 0,
            "ratio": 0
          }
        ],
        "keywords": [
          { "keyword": "식다", "review_count": 18 },
          { "keyword": "늦다", "review_count": 12 },
          { "keyword": "양", "review_count": 9 }
        ]
      },
      {
        "sentiment": "POSITIVE",
        "total_review_count": 1043,
        "categories": [
          {
            "category": "TASTE",
            "label": "맛",
            "review_count": 702,
            "ratio": 67.3
          }
        ],
        "keywords": [{ "keyword": "푸짐하다", "review_count": 88 }]
      }
    ]
  }
}

Description ​

필드타입설명
from, tostring실제로 적용된 집계 기간 (KST)
analyzed_throughstring | null분석이 끝난 마지막 날짜 (KST). now - 1 day 까지 집계하며, to 가 이보다 늦어도 이 날짜까지만 집계
sentimentsarrayNEGATIVE, POSITIVE
sentiments[].sentimentenumNEGATIVE or POSITIVE
sentiments[].total_review_countnumber기간 내 해당 긍부정 리뷰 수
sentiments[].categoriesarray카테고리 순위 (아래 설명 참고)
sentiments[].keywordsarray많이 나온 키워드 상위 30개

카테고리 순위(categories) ​

  • 리뷰 수가 많은 순서이고, 같으면 아래 표 순서입니다.
  • 리뷰가 1건 이상 있으면 기타를 뺀 모든 카테고리가 나옵니다. 리뷰가 없는 카테고리는 review_count 와 ratio 가 0 입니다.
  • 기간 내 리뷰가 0건이면 빈 배열입니다.
  • 한 리뷰가 여러 카테고리에 동시에 속할 수 있어 ratio 의 합은 100을 넘을 수 있습니다.
categorylabel
TASTE맛
QUANTITY양
FRESHNESS_HYGIENE신선/위생
MENU_COMPOSITION메뉴/구성
SERVICE서비스/응대
DELIVERY_PACKAGING배달/포장

화면 표시에는 label 을 그대로 쓰고, category 는 고객 불만족 요인 분석 원문 조회의 필터 값으로 써 주세요.

키워드(keywords) ​

  • 기간 내 2건 이상 나온 키워드만, 많은 순서로 최대 30개입니다.

분석 데이터의 한계

  • 분석은 하루 한 번 새벽에 돌아 전날까지 반영됩니다. 오늘 들어온 리뷰는 다음 날 집계됩니다. 기준 날짜는 analyzed_through 로 확인해 주세요.
  • 분석 데이터는 최근 190일만 보관합니다. 그보다 오래된 기간은 0건으로 나옵니다.

Error Case ​

json
{
  "status": "PARTNER_API_INVALID_PARAMETER",
  "status_code": 400,
  "message": "요청을 처리할 수 없습니다."
}
status_codestatus이 API 에서 발생하는 경우
400PARTNER_API_INVALID_PARAMETER날짜 형식 오류, from 이 to 보다 늦음, 없는 platform 값
401PARTNER_API_KEY_REQUIREDx-partner-api-key 헤더 누락
401PARTNER_API_KEY_INVALID등록되지 않은 키
401PARTNER_API_KEY_INACTIVE폐기된 키
401PARTNER_API_KEY_EXPIRED만료된 키
403PARTNER_API_FORBIDDEN비활성화된 협력사 (담당자 문의)
404PARTNER_API_BRAND_NOT_FOUNDbrand_code 가 없거나 이 키의 범위 밖
404PARTNER_API_USER_NOT_FOUNDuser_code 가 없거나 이 브랜드 소속이 아님
404PARTNER_API_NOT_FOUND잘못된 URL 경로
429PARTNER_API_RATE_LIMITED호출 제한 초과 (분당 100회)
500PARTNER_API_INTERNAL_ERROR서버 오류