VIBE HOTDEAL API
커뮤니티 핫딜을 크롤링해 정규화된 API로 제공합니다
뽐뿌, 클리앙 등 국내 커뮤니티에 올라오는 핫딜을 실시간으로 수집해 상품명, 가격, 할인 조건, 판매처, 카테고리, AI 점수로 정규화한 뒤 JSON REST API로 전달합니다. 크롤러를 직접 운영하지 않아도 딜 데이터를 연동할 수 있습니다.
무엇을 하나요
- 국내 주요 커뮤니티 핫딜 게시판 실시간 크롤링
- 제목·가격·할인율·판매처·카드 할인·카테고리 정규화
- AI 점수 산출 (가격 매력도, 할인 조건, 커뮤니티 반응 종합)
- 판매종료 상태 추적 및 자동 반영
- 검색, 필터, 정렬, 커서 페이지네이션 지원
API 엔드포인트
| 메서드 | 경로 | 설명 |
|---|---|---|
| GET | /api/deals/latest | 최신 딜 목록 |
| GET | /api/deals/search | 검색 + 필터 + 커서 페이지네이션 |
| GET | /api/deals/top | 시간 범위 내 조회수 상위 딜 |
모든 엔드포인트는 JSON 응답을 반환하며, 카테고리·가격 범위·시간 범위로 필터링할 수 있습니다.
응답 데이터 스키마
| 필드 | 타입 | 설명 |
|---|---|---|
| title | string | 딜 제목 |
| price | number | 현재 판매가 (원) |
| originalPrice | number | null | 원가 |
| discountRate | number | 할인율 (%) |
| category | object | super / primary / secondary 카테고리 |
| retailer | string | 판매처 (쿠팡, 11번가, G마켓 등) |
| source | string | 원글 커뮤니티 (뽐뿌, 클리앙 등) |
| aiScore | number | AI 가격 매력도 점수 |
| thumbnailUrl | string | 상품 썸네일 이미지 URL |
| writtenAt | ISO 8601 | 원글 작성 시각 |
| status | string | 판매중 | 판매종료 |
이런 경우에 사용합니다
- 핫딜聚合 서비스나 가격 비교 앱을 만들 때 — 크롤러 없이 데이터만 연동
- 제휴 마케팅 (LinkPrice 등) — 정규화된 판매처 URL로 즉시 전환 링크 생성
- 사내 가격 모니터링 — 경쟁사·카테고리별 딜 추이 파악
- AI/LLM 파이프라인 — 구조화된 딜 데이터를 RAG 소스로 활용
운영 기준
30초
최신 딜 캐시 갱신 주기 (s-maxage)
200건
요청당 최대 반환 딜 수
12개
슈퍼 카테고리 분류
위 수치는 현재 운영 설정 기준이며, SLA 보장이 아닌 측정 목표입니다.
API 키 발급 및 문의
API 키는 현재 별도 문의를 통해 발급합니다. 요금제, 레이트 리밋 상향, 전용 인스턴스 등 조건은 협의 가능합니다.