소개

댓글몽에 수집된 브랜드, 매장, 리뷰 데이터를 조회할 수 있는 읽기 전용 REST API 입니다.

Base URL

https://api.lemong.ai

모든 요청은 HTTPS로만 가능합니다.

Request

모든 엔드포인트는 GET 이며, 발급받은 API 키를 x-partner-api-key 헤더에 담아 호출합니다.

curl -H 'x-partner-api-key: YOUR_API_KEY' \
  'https://api.lemong.ai/partner/v1/health'

Response 형식

모든 Response는 아래의 형식을 따릅니다.

{
  "status": "SUCCESS",
  "status_code": 200,
  "message": "OK",
  "data": { ... }
}

필드	설명
status	SUCCESS 또는 에러 코드
status_code	http의 response code
message	사람이 읽는 메시지
data	실제 데이터

데이터 특성

• 리뷰·매장 데이터는 배달 플랫폼에서 수집한 데이터입니다. 수집 주기에 따른 지연이나 일시적 공백이 있을 수 있습니다.
• 모든 시각 필드는 한국 시간(KST) 이며 오프셋(+09:00)이 함께 표기됩니다.
• 리뷰 본문(content)에 고객이 직접 기재한 개인 정보는 따로 수정하지 않고 플랫폼에 등록된 리뷰 원문 그대로 노출됩니다.

Health Check

연동 전 헬스체크를 호출해 주세요. 200이 오면 API와 키가 모두 정상입니다.

버전 관리

현재 버전은 v1이며, 경로에 포함됩니다(/partner/v1/...).

• 하위 호환 변경(응답 필드 추가, 선택적 파라미터 추가, 엔드포인트 추가)은 v1에 반영될 수 있습니다. 클라이언트는 모르는 필드를 무시하도록 구현해 주세요.
• 하위 호환이 깨지는 변경(필드 삭제, 이름 변경, 의미 변경)은 v1에 반영되지 않습니다. 필요 시 /partner/v2 로 별도 제공되며, v1 은 사전 공지된 지원 종료일까지 병행 운영됩니다.

Rate Limit

IP 당 분당 100회입니다. 초과하면 HTTP 429가 반환되며, 잠시 후 다시 시도해 주세요.