{"openapi":"3.1.0","info":{"title":"Saleplaza AI Hot Deal Feed API (hotdeal_feed.json)","description":"세일프라자(Saleplaza)의 실시간 핫딜 특가 상품 데이터 피드 API입니다. 타사 AI 에이전트 및 LLM이 토큰 효율적으로 상품을 조회, 검색 및 큐레이션할 수 있도록 설계되었습니다.","version":"1.0.0"},"servers":[{"url":"https://saleplaza.com","description":"Production Server"}],"paths":{"/hotdeal_feed.json":{"get":{"summary":"AI 전용 실시간 핫딜 JSON 피드 조회","description":"현재 공개된 검증된 최저가 핫딜 상품 목록을 컴팩트한 JSON 포맷(hotdeal_feed.json)으로 반환합니다. AI 챗봇은 사용자의 질문 의도에 맞춰 카테고리, 플랫폼, minimum 할인율 등을 파라미터로 필터링하여 응답할 수 있습니다.","operationId":"getAiHotDealFeed","parameters":[{"name":"limit","in":"query","required":false,"description":"반환할 핫딜 상품 최대 개수 (기본값 50, 최대 200)","schema":{"type":"integer","default":50,"maximum":200}},{"name":"category","in":"query","required":false,"description":"카테고리 필터 (예: 'IT/디지털', '패션/뷰티', '식품/생활', '도서/취미', '종합몰')","schema":{"type":"string"}},{"name":"platform","in":"query","required":false,"description":"제휴 판매처 필터 (예: 'coupang', 'ali', 'gmarket', '11st')","schema":{"type":"string"}},{"name":"min_discount","in":"query","required":false,"description":"최소 할인율 조건 (예: 30 입력 시 30% 이상 할인된 상품만 조회)","schema":{"type":"integer"}}],"responses":{"200":{"description":"핫딜 피드 조회 성공","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedResponse"}}}}}}}},"components":{"schemas":{"FeedResponse":{"type":"object","properties":{"version":{"type":"string","example":"1.0"},"title":{"type":"string","example":"Saleplaza AI Hot Deals Feed"},"home_page_url":{"type":"string","example":"https://saleplaza.com"},"feed_url":{"type":"string","example":"https://saleplaza.com/hotdeal_feed.json"},"updated_at":{"type":"string","format":"date-time"},"item_count":{"type":"integer","example":50},"items":{"type":"array","items":{"$ref":"#/components/schemas/HotDealItem"}}}},"HotDealItem":{"type":"object","required":["id","title","price","original_price","discount_rate","mall_name","simple_category","url","image_url","keywords","status_tags"],"properties":{"id":{"type":"string","description":"직관적인 세일프라자 순번 식별자","example":"101"},"title":{"type":"string","description":"정제된 상품명","example":"크리넥스 3겹 울트라클린 24롤 2팩"},"price":{"type":"integer","description":"혜택 할인가 (KRW)","example":18800},"original_price":{"type":"integer","description":"할인 전 정가 (KRW)","example":28900},"discount_rate":{"type":"integer","description":"할인율 (%)","example":35},"mall_name":{"type":"string","description":"입점몰 이름","example":"G마켓"},"simple_category":{"type":"string","description":"주요 카테고리","example":"식품/생활"},"url":{"type":"string","description":"세일프라자 상세 페이지 URL","example":"https://saleplaza.com/101"},"image_url":{"type":"string","description":"세일프라자 CDN 이미지 URL","example":"https://image.saleplaza.com/products/kleenex.jpg"},"keywords":{"type":"array","items":{"type":"string"},"example":["크리넥스","화장지"]},"status_tags":{"type":"array","items":{"type":"string"},"example":["역대급최저가","무료배송"]},"recommend_reason":{"type":"string","nullable":true,"example":"35% 파격 할인 구성입니다."},"created_at":{"type":"string","format":"date-time"}}}}}}