상품 정보와 판매가
상품번호, 상품명, 용량, 병 수, 공개 판매가를 제공합니다. 단품·세트·옵션은 각각의 판매 조건으로 구분합니다.
키햐 상품 API
키햐 상품 데이터를
키햐 상품 데이터를
서비스에 연동하세요.
상품명, 용량, 판매가, 판매 상태와 구매 링크를 API와 CSV로 제공합니다. 가격 비교, 상품 추천, 콘텐츠 등 만들고 싶은 서비스에 활용하세요.
베타 기간 무료 · 프로젝트와 상품 범위 승인 후 이용GET/api/v1/products200 OK
{
"product_id": "9999990001",
"offer_id": "9999990001:base",
"name": "예시 준마이 사케 720ml",
"volume_ml": 720,
"price": {
"amount": 32000,
"currency": "KRW"
},
"availability": "in_stock",
"display_allowed": true
}JSON 응답 일부 · 가상 상품JSON · CSV
제공 데이터
상품과 옵션을 구분해 조회할 수 있습니다.
상품 링크와 수령 방식
상품 URL과 프로젝트별 UTM 링크를 제공합니다. 매장 픽업 등 수령 방식과 지역도 확인할 수 있습니다.
판매 상태와 확인 시각
판매·표시 가능 여부, 마지막 확인 시각, 데이터 유효 시각을 제공합니다. 전체 목록과 변경 내역을 조회할 수 있습니다.
연동 방법
개인 개발자와 기업 모두 신청할 수 있습니다.
로그인
이메일로 받은 6자리 인증 코드를 입력합니다.
프로젝트 신청
서비스 URL, 사용 목적, 필요한 상품을 입력합니다.
API 키 발급
프로젝트와 상품 범위 승인 후 키를 발급합니다.
API 호출
서버에서 Bearer 인증으로 상품을 조회합니다. CSV도 받을 수 있습니다.
자주 묻는 질문
어떤 서비스에 활용할 수 있나요?
가격 비교, 상품 추천, 주류 정보 서비스, 콘텐츠의 구매 링크 등에 활용할 수 있습니다. 만들려는 서비스와 필요한 상품 범위를 신청해 주세요. 이미지·상세 콘텐츠와 고객·주문·결제 정보는 v1 제공 범위에 포함되지 않습니다.
해외에서도 신청할 수 있나요?
이메일 인증으로 신청할 수 있으며 국내 휴대폰 번호는 필요하지 않습니다. 영어 Quickstart도 제공합니다.
데이터는 얼마나 자주 갱신하나요?
1시간마다 수집을 권장하며 최소 하루 1회 전체 목록을 갱신해 주세요. 각 상품의 유효 시각을 따르고 품절·판매 종료 상품은 숨깁니다. 제공 정책은 최대 5분 간격으로 확인합니다. 갱신·삭제 규칙에서 처리 방법을 확인하세요.
브라우저나 앱에서 직접 호출할 수 있나요?
서버 간 호출을 지원합니다. API 키는 서버에 보관하고, 브라우저나 앱에는 서버에서 받은 상품 데이터를 전달해 주세요.
요금과 호출 한도는 어떻게 되나요?
베타 기간에는 무료입니다. 기본 한도는 프로젝트 합산 분당 60회, 하루 10,000회입니다. 프로젝트별 적용 한도와 사용량은 대시보드에서 확인할 수 있습니다.
필요한 상품 데이터를 신청하세요.
제공 필드와 요청 예시는 API 문서에서 확인할 수 있습니다.