{"openapi":"3.1.0","info":{"title":"바닥가 쿠팡 가격 기록 조회","description":"쿠팡 상품의 현재가와 가격 기록(기록 최저가·최고가, 지금 사도 되는지 판정)을 조회합니다. 읽기 전용입니다.","version":"1.0.0"},"servers":[{"url":"https://badakga.com"}],"paths":{"/api/search":{"get":{"operationId":"searchProducts","summary":"상품 이름으로 쿠팡 가격 기록을 찾습니다.","description":"상품 이름(예: 에어팟 프로 3, 갤럭시 핏3)으로 바닥가가 추적하는 쿠팡 상품을 찾아 현재가, 기록 최저가, 판정을 돌려줍니다.","parameters":[{"name":"q","in":"query","required":true,"description":"찾을 상품 이름. 브랜드와 모델명 위주로 2~4단어가 좋습니다. 결과가 없으면 단어를 줄여 다시 찾으세요.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"돌려받을 상품 수(1~20, 기본 8).","schema":{"type":"integer","minimum":1,"maximum":20,"default":8}}],"responses":{"200":{"description":"검색 결과","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}}}}},"/api/product/{key}":{"get":{"operationId":"getProduct","summary":"상품 한 개의 가격 기록을 조회합니다.","description":"바닥가 상품 키(상품번호-옵션번호, 예: 9115997536-26812414346)로 한 상품의 현재가와 가격 기록을 돌려줍니다. 키는 검색 결과 url의 /p/ 뒤에 있습니다.","parameters":[{"name":"key","in":"path","required":true,"description":"상품번호-옵션번호","schema":{"type":"string"}}],"responses":{"200":{"description":"상품 정보","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResult"}}}},"404":{"description":"추적하지 않는 상품"}}}}},"components":{"schemas":{"Product":{"type":"object","properties":{"name":{"type":"string"},"category":{"type":"string"},"price":{"type":"integer","description":"현재가(원)"},"price_text":{"type":"string"},"lowest_recorded":{"type":"integer","description":"바닥가가 기록한 기간 중 최저가(원)"},"highest_recorded":{"type":"integer","description":"기록 기간 중 최고가(원)"},"lowest_recorded_date":{"type":"string"},"days_tracked":{"type":"integer","description":"가격을 기록한 일수"},"verdict":{"type":"string","description":"지금 가격 판정"},"verdict_detail":{"type":"string"},"is_lowest_in_record":{"type":"boolean","description":"지금이 기록 기간 중 최저가인지"},"lowest_in_last_days":{"type":["integer","null"],"description":"최근 N일 중 최저가이면 N(7, 30 등)"},"price_checked_at":{"type":"string","description":"가격 확인 시각(ISO 8601)"},"url":{"type":"string","description":"가격 그래프가 있는 바닥가 상품 페이지. 사용자에게 이 주소를 안내하세요."}}},"SearchResult":{"type":"object","properties":{"query":{"type":"string"},"total":{"type":"integer"},"match":{"type":"string","description":"exact: 이름이 맞는 상품, similar: 비슷한 상품, none: 없음"},"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"checked_at":{"type":"string"},"note":{"type":"string"},"disclosure":{"type":"string"}}},"ProductResult":{"type":"object","properties":{"product":{"$ref":"#/components/schemas/Product"},"checked_at":{"type":"string"},"note":{"type":"string"},"disclosure":{"type":"string"}}}}}}