고객 불만족 요인 분석 원문 조회

고객 불만족 요인 분석 조회 결과인 카테고리나 키워드에 해당하는 리뷰 원문을 반환합니다. 리뷰 작성일 최신순입니다.

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

Request

bash

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

쿼리 파라미터

파라미터	필수 여부	타입	설명
`from`	optional	`YYYY-MM-DD`	리뷰 작성일 시작 (KST, 포함) - 생략 시 `to` 기준 30일 전
`to`	optional	`YYYY-MM-DD`	리뷰 작성일 끝 (KST, 포함) - 생략 시 오늘
`platform`	optional	enum	`BAEMIN`, `YOGIYO`, `CPEATS`
`user_code`	optional	string	점주 목록 조회의 `user_code`
`category`	optional	string	카테고리 코드 (인사이트 응답의 `categories[].category`)
`keyword`	optional	string	키워드 (인사이트 응답의 `keywords[].keyword`), 최대 50자
`sentiment`	optional	enum	`NEGATIVE` 부정만, `POSITIVE` 긍정만 - 생략 시 둘 다
`page`	optional	number	기본 1
`limit`	optional	number	기본 20, 최대 100

category 와 keyword 는 둘 중 하나만 지정할 수 있습니다.
둘 다 생략하면 기간 내 리뷰 전체를 반환합니다.
keyword 는 인사이트 응답에 나온 키워드를 그대로 넣어야 합니다. 원문 부분 일치 검색이 필요하면 리뷰 조회의 keyword 를 사용해 주세요.

bash

curl -H 'x-partner-api-key: YOUR_API_KEY' \
  'https://api.lemong.ai/partner/v1/brands/BRAND100/review-insights/reviews?keyword=%EC%8B%9D%EB%8B%A4&sentiment=NEGATIVE'

Response

json

{
  "status": "SUCCESS",
  "status_code": 200,
  "message": "OK",
  "data": {
    "items": [
      {
        "review_id": "1234567890",
        "user_code": "U0001",
        "platform_shop_id": "12345678",
        "shop_name": "몽도시락 강남점",
        "platform": "BAEMIN",
        "date": "2026-10-20T12:30:00+09:00",
        "content": "음식이 다 식어서 왔어요",
        "rating": 2,
        "menus": ["제육도시락"],
        "images": [],
        "categories": [
          { "code": "TASTE", "label": "맛" },
          { "code": "DELIVERY_PACKAGING", "label": "배달/포장" }
        ],
        "sentiment": "NEGATIVE"
      }
    ],
    "page": 1,
    "limit": 20,
    "has_next": false
  }
}

Description

필드	타입	설명
`review_id`	string	리뷰 id
`user_code`	string \| null	점주 코드
`platform_shop_id`	string	플랫폼 측 매장 id
`shop_name`	string	매장명
`platform`	enum	플랫폼
`date`	string \| null	플랫폼 기준 리뷰 작성일 (KST)
`content`	string	리뷰 본문
`rating`	number \| null	1~5, 별점 없는 리뷰는 `null`
`menus`	string[]	주문 메뉴
`images`	string[]	리뷰 이미지 URL
`categories`	array	분류 카테고리
`sentiment`	enum	`NEGATIVE` or `POSITIVE`

리뷰 조회 API와의 차이

본문이 없는 리뷰는 포함되지 않습니다. 별점만 남겼거나 이모지, 기호만 쓴 리뷰는 분석할 수 없어 제외됩니다. 따라서 같은 기간이라도 리뷰 조회보다 건수가 적습니다.
답변 여부나 대응 상태는 담지 않습니다. 필요 시 review_id 로 리뷰 단건 조회를 호출해 주세요.

분석 데이터의 한계

분석은 하루 한 번 새벽에 돌아 전날까지 반영됩니다. 오늘 들어온 리뷰는 다음 날부터 조회됩니다.
분석 데이터는 최근 190일만 보관합니다.

Error Case

json

{
  "status": "PARTNER_API_INVALID_PARAMETER",
  "status_code": 400,
  "message": "요청을 처리할 수 없습니다."
}

`status_code`	`status`	이 API 에서 발생하는 경우
400	`PARTNER_API_INVALID_PARAMETER`	날짜 형식 오류, `from` 이 `to` 보다 늦음, 없는 `platform` 또는 `category`, `category` 와 `keyword` 동시 지정
401	`PARTNER_API_KEY_REQUIRED`	`x-partner-api-key` 헤더 누락
401	`PARTNER_API_KEY_INVALID`	등록되지 않은 키
401	`PARTNER_API_KEY_INACTIVE`	폐기된 키
401	`PARTNER_API_KEY_EXPIRED`	만료된 키
403	`PARTNER_API_FORBIDDEN`	비활성화된 협력사 (담당자 문의)
404	`PARTNER_API_BRAND_NOT_FOUND`	`brand_code` 가 없거나 이 키의 범위 밖
404	`PARTNER_API_USER_NOT_FOUND`	`user_code` 가 없거나 이 브랜드 소속이 아님
404	`PARTNER_API_NOT_FOUND`	잘못된 URL 경로
429	`PARTNER_API_RATE_LIMITED`	호출 제한 초과 (분당 100회)
500	`PARTNER_API_INTERNAL_ERROR`	서버 오류

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

Request ​

쿼리 파라미터 ​

Response ​

Description ​

Error Case ​

고객 불만족 요인 분석 원문 조회

Request

쿼리 파라미터

Response

Description

Error Case