데이터 제공 · 임베드

핫딜 허브이(가) 수집한 상품권 핫딜 데이터를 JSON 피드와 임베드 위젯으로 제공합니다. 시세 사이트, 커뮤니티, 블로그 어디서든 가져다 쓸 수 있습니다.

이용 조건

출처 표기: 데이터를 표시하는 화면에 "출처: 핫딜 허브"과 이 사이트로의 링크를 함께 표시합니다. 응답의 source 필드를 그대로 쓰면 됩니다.
재판매 금지: 데이터 자체를 유료로 판매하거나 유료 API로 재제공할 수 없습니다. 자신의 서비스 안에서 표시하는 것은 자유입니다.
호출 간격: 피드는 15분 캐시됩니다. 같은 엔드포인트를 15분에 1회 이상 호출할 필요가 없습니다.
원문 존중: 딜의 원문 커뮤니티 글 링크(deal_url)를 제거하지 않습니다.
제외 요청으로 삭제된 딜은 피드에서도 사라집니다. 캐시한 데이터도 24시간 내 갱신해 주세요.

JSON 피드

경로	설명
/api/deals.json	진행 중 딜. ?limit=50&status=active\|live\|ending\|ended&brand=슬러그&category=gift&sort=score\|recent\|discount
/api/brands.json	브랜드 슬러그 목록
/api/brands/{slug}.json	브랜드별 딜
/api/weekly/{YYYY-Www}.json	주차별 딜(브랜드 묶음)
/api/deals/{id}.json	딜 상세(출처 글, 일별 가격, 과거 반복)
/api/status.json	마지막 갱신 시각, 갱신 지연 여부

기본 주소: https://hotdeal-hub-worker.increw01.workers.dev. CORS 허용. 정적 사본 https://hotdeal-hub.pages.dev/api/deals.json은 1시간마다 갱신되며 API 장애 시 대체용입니다.

응답 예시 (deals 항목 1건)

{
  "id": "8815d95475eac671",
  "iso_week": "2026-W44",
  "brand": "cultureland",
  "brand_name": "컬쳐랜드",
  "merchant": "gmarket",
  "merchant_name": "지마켓",
  "category": "gift",
  "title": "[지마켓] 컬쳐랜드 문화상품권 5만원권 (46,000원/무료) 신한카드 1인 3매",
  "face_value": 50000,
  "sale_price": 46000,
  "discount_rate": 8,
  "card_issuers": [
    "shinhan"
  ],
  "card_benefit": "신한카드 즉시할인",
  "limit_per_person": "1인 3매",
  "payment_note": "즉시할인",
  "buy_rate": null,
  "rate_gap": null,
  "rate_source": null,
  "deal_url": "https://www.ppomppu.co.kr/zboard/view.php?id=ppomppu&no=900001",
  "is_affiliate": false,
  "status": "live",
  "score": 2.13,
  "votes_total": 51,
  "comments_total": 21,
  "first_seen": "2026-10-26T08:10:00.000Z",
  "last_seen": "2026-10-26T08:58:00.000Z",
  "ended_at": null,
  "repeat_weeks": 3,
  "sources": [
    "ppomppu",
    "clien"
  ]
}

임베드 위젯

옵션을 고르면 코드가 바뀝니다. 출처 링크가 위젯 안에 포함되므로 별도 표기 없이 그대로 쓸 수 있습니다. 스크립트 방식은 페이지 글꼴·배경과 자연스럽게 어울리고, iframe 방식은 어떤 CMS에서도 동작합니다.

스크립트 방식

iframe 방식

iframe 높이를 자동으로 맞추려면 부모 페이지에서 message 이벤트의 type: "hotdeal-widget:height"를 받아 iframe.style.height에 넣으면 됩니다.

미리보기

사용 가능한 브랜드 슬러그: cultureland happymoney booknlife shinsegae lotte hyundai galleria emart homeplus naverpay kakaopay google nexon starbucks cgv