리뷰 집계 조회

브랜드의 기간 리뷰 수, 답변 수, 별점 분포를 반환합니다. 댓글몽 브랜드 리뷰 현황 화면과 동일한 일별 집계를 소스로 씁니다.

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

리뷰 건수나 답변률 같은 수치가 필요할 때 씁니다. 리뷰 원문 조회는 리뷰 조회 API를 사용해 주세요.

Request

bash

curl -H 'x-partner-api-key: YOUR_API_KEY' \
  'https://api.lemong.ai/partner/v1/brands/BRAND100/review-stats?from=2026-08-01&to=2026-08-31&group_by=shop'

쿼리 파라미터

파라미터	타입	설명
`from`	`YYYY-MM-DD`	집계 시작일 (KST, 포함) - 생략 시 `to` 기준 30일 전
`to`	`YYYY-MM-DD`	집계 종료일 (KST, 포함) - 생략 시 오늘
`group_by`	enum	집계 단위. 기본 `date`
`platform`	enum	특정 플랫폼만
`platform_shop_id`	string	특정 매장만
`page`	number	기본 1
`limit`	number	기본 20, 최대 100

Response

date 는 최신순, 그 외에는 리뷰 수 내림차순입니다.

json

{
  "status": "SUCCESS",
  "status_code": 200,
  "message": "OK",
  "data": {
    "items": [
      {
        "group_by": "shop",
        "date": null,
        "platform_shop_id": "12345678",
        "shop_name": "몽도시락 강남점",
        "platform": "BAEMIN",
        "review_count": 412,
        "reply_count": 397,
        "rating_counts": {
          "one": 12,
          "two": 8,
          "three": 21,
          "four": 74,
          "five": 297
        }
      },
      {
        "group_by": "shop",
        "date": null,
        "platform_shop_id": "123456789",
        "shop_name": "몽도시락 역삼점",
        "platform": "CPEATS",
        "review_count": 268,
        "reply_count": 251,
        "rating_counts": {
          "one": 9,
          "two": 11,
          "three": 24,
          "four": 63,
          "five": 161
        }
      }
    ],
    "page": 1,
    "limit": 20,
    "has_next": false
  }
}

Description

필드	타입	설명
`group_by`	enum	집계 단위
`date`	string \| null	집계 일자 (KST)
`platform_shop_id`	string \| null	플랫폼 측 매장 id
`shop_name`	string \| null	매장명
`platform`	enum \| null	플랫폼
`review_count`	number	기간 합산 리뷰 수
`reply_count`	number	기간 합산 답변 수
`rating_counts`	object	별점별 리뷰 수

platform 값

값	플랫폼
`BAEMIN`	배달의민족
`CPEATS`	쿠팡이츠
`YOGIYO`	요기요
`DDANGYO`	땡겨요
`NAVER`	네이버 플레이스
`MUKKEBI`	먹깨비

집계 단위(group_by)

값	집계 기준
`date`	일자별 (기본값)
`shop`	매장별
`platform`	플랫폼별

필드 존재 여부

집계 단위에 따라 채워지는 필드가 달라집니다. 소수점 별점(4.5)은 내린 값(4)의 칸에 집계됩니다.

필드	`date`	`shop`	`platform`
`review_count`, `reply_count`, `rating_counts`	O	O	O
`date`	O	-	-
`platform`	-	O	O
`platform_shop_id`, `shop_name`	-	O	-

집계 데이터의 한계

일별 집계는 하루 한 번 갱신되며, 당일 데이터는 집계되지 않습니다. 따라서 실시간 조회인 리뷰 조회를 같은 기간으로 세어도 해당 값과 다를 수 있습니다.
집계가 없는 대상은 응답에 나오지 않습니다.

Error Case

json

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

`status_code`	`status`	이 API 에서 발생하는 경우
400	`PARTNER_API_INVALID_PARAMETER`	날짜 형식 오류, `from` 이 `to` 보다 늦음, 잘못된 `group_by`
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_NOT_FOUND`	잘못된 URL 경로
429	`PARTNER_API_RATE_LIMITED`	호출 제한 초과 (분당 100회)
500	`PARTNER_API_INTERNAL_ERROR`	서버 오류

리뷰 집계 조회 ​

Request ​

쿼리 파라미터 ​

Response ​

Description ​

platform 값 ​

집계 단위(group_by) ​

필드 존재 여부 ​

Error Case ​