페이징과 데이터 조회

페이징

모든 목록 엔드포인트는 page / limit 쿼리 파라미터를 받습니다.

파라미터	기본값	최대
page	1	-
limit	20	100

응답에는 총건수 대신 has_next 가 실립니다. has_next 가 false 가 될 때까지 page 를 올려가며 호출하면 됩니다.

{
  "status": "SUCCESS",
  "status_code": 200,
  "message": "OK",
  "data": {
    "items": [ ... ],
    "page": 1,
    "limit": 20,
    "has_next": true
  }
}

주기적으로 수집하기

리뷰 조회는 기간(from/to) 기준입니다. 기간은 리뷰 작성일(플랫폼 기준, KST 달력)로 판정합니다.

리뷰는 플랫폼에서 주기적으로 수집하기 때문에 작성 직후 바로 조회되지 않습니다. 따라서 어제 날짜만 한 번 읽는 방식은 뒤늦게 수집된 리뷰를 놓칩니다. 최근 며칠 구간을 겹쳐 읽고 review_id 기준으로 upsert 하는 방식을 권장합니다.

권장 패턴

1. 하루 수 회, from 을 오늘로부터 3~7일 전, to 를 오늘로 두고 호출합니다.
2. has_next가 false가 될 때까지 page 를 올려가며 순회해 조회합니다.
3. 리뷰를 review_id기준으로 upsert합니다.

curl -H 'x-partner-api-key: YOUR_API_KEY' \
  'https://api.lemong.ai/partner/v1/brands/BRAND100/reviews?from=2026-08-07&to=2026-08-13&page=1&limit=100'

폴링 주기는 5분 이상을 권장합니다. 호출 제한(분당 100회) 안에서 브랜드 수 × 페이지 수를 감안해 조정하세요.

수집 이후의 변경은 별도로 추적하고 있지 않습니다.

리뷰 내용, 별점이 플랫폼에서 나중에 바뀌거나 답변이 새로 달려도, 그 변경만 골라내는 조회는 제공하지 않습니다. 최신 상태가 필요하면 위와 같이 해당 기간을 다시 읽어 upsert해 주세요.