{"openapi":"3.0.3","info":{"title":"APICK 낙찰 경쟁 분석","version":"1.0.0","description":"업무구분·조회 기간·입찰공고번호로 공공기관 낙찰 결과를 모아 평균·중위 낙찰률, 낙찰률 분포, 업체별 낙찰 점유와 집중도(HHI), 낙찰률이 낮은 공고를 분석합니다. 투찰 가격 전략과 경쟁사 파악에 바로 쓸 수 있는 집계를 돌려줍니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/bid_award":{"post":{"summary":"낙찰 경쟁 분석","description":"업무구분·조회 기간·입찰공고번호로 공공기관 낙찰 결과를 모아 평균·중위 낙찰률, 낙찰률 분포, 업체별 낙찰 점유와 집중도(HHI), 낙찰률이 낮은 공고를 분석합니다. 투찰 가격 전략과 경쟁사 파악에 바로 쓸 수 있는 집계를 돌려줍니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"summary":{"type":"object","properties":{"total":{"type":"integer","description":"분석한 낙찰 결과 수입니다. 요청한 페이지의 결과 수와 같습니다."},"winner_count":{"type":"integer","description":"서로 다른 낙찰 업체 수입니다."},"avg_success_rate":{"type":"number","description":"평균 낙찰률(%)입니다. 소수 둘째 자리까지 반올림하며 낙찰률을 아는 결과가 없으면 null입니다.","nullable":true},"median_success_rate":{"type":"number","description":"낙찰률 중앙값(%)입니다. 소수 둘째 자리까지 반올림합니다."},"success_rate_stdev":{"type":"number","description":"낙찰률 표본 표준편차(%p)입니다. 낙찰률을 아는 결과가 2건 미만이면 null입니다.","nullable":true},"avg_participants":{"type":"number","description":"결과 한 건당 평균 참여 업체 수입니다. 소수 첫째 자리까지 반올림합니다."},"rate_sample":{"type":"integer","description":"낙찰률 통계에 쓴 결과 수입니다. total보다 작으면 일부 결과에 낙찰률이 없습니다."},"winner_concentration_hhi":{"type":"integer","description":"낙찰 집중도(HHI, 0~10000)입니다. 업체별 낙찰 건수 점유율(%)을 제곱해 더한 값으로, 클수록 소수 업체에 몰려 있습니다. 낙찰 업체가 없으면 null입니다.","nullable":true},"success_amount_total":{"type":"integer","description":"낙찰금액 합계(원)입니다. 낙찰금액을 아는 결과가 없으면 null입니다.","nullable":true}}},"distribution":{"type":"object","properties":{"by_winner":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"number"}}},"description":"낙찰 건수 상위 10개 업체입니다. 항목은 name·count·share_pct(전체 결과 대비 %, 소수 첫째 자리)입니다."},"by_agency":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"number"}}},"description":"발주기관별 결과 수 상위 10곳입니다. 항목 구성은 by_winner와 같습니다."},"by_rate_band":{"type":"array","items":{"type":"object","properties":{"band":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"number"}}},"description":"낙찰률 구간별 분포입니다. 항목은 band·count·share_pct(낙찰률을 아는 결과 대비 %)입니다. band는 70% 미만)·70~80%·80~85%·85~88%·88~90%·90~95%·95~100% 순서로 0건이어도 모두 오며, 100% 이상인 결과가 있을 때만 100% 이상이 붙습니다. 각 구간은 앞 값 이상, 뒤 값 미만입니다."}}},"competitors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"낙찰 업체 이름입니다."},"wins":{"type":"integer","description":"낙찰 건수입니다."},"share_pct":{"type":"number","description":"전체 결과 대비 낙찰 점유율(%)입니다. 소수 첫째 자리까지 반올림합니다."},"amount_total":{"type":"integer","description":"그 업체의 낙찰금액 합계(원)입니다. 알 수 없으면 null입니다.","nullable":true}}},"description":"낙찰 건수 상위 10개 업체의 요약입니다."},"low_rate":{"type":"array","items":{"type":"object","properties":{"bid_no":{"type":"string","description":"입찰공고번호입니다."},"bid_name":{"type":"string","description":"공고명입니다."},"agency":{"type":"string","description":"수요기관(없으면 공고기관) 이름입니다. 없으면 빈 문자열입니다."},"winner":{"type":"string","description":"낙찰 업체 이름입니다."},"success_amount":{"type":"integer","description":"낙찰금액(원)입니다. 알 수 없으면 null입니다.","nullable":true},"success_rate":{"type":"number","description":"낙찰률(%)입니다. 소수 둘째 자리까지 반올림합니다."},"participants":{"type":"integer","description":"참여 업체 수입니다. 알 수 없으면 null입니다.","nullable":true},"opened_at":{"type":"string","description":"개찰 일시 문자열입니다. 예: 2026-10-08 11:00:00"}}},"description":"낙찰률이 80% 미만인 결과를 낙찰률이 낮은 순서로 최대 10건 담습니다."},"insights":{"type":"array","items":{"type":"string"},"description":"집계에서 뽑은 한국어 요약 문장입니다. 화면에 그대로 보여 줄 수 있습니다."}}},"api":{"type":"object","properties":{"cost":{"type":"integer","description":"차감된 포인트입니다. 실패한 응답은 0입니다."},"success":{"type":"boolean"},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"bizType":{"type":"string","description":"업무구분 (물품·공사·용역·외자, 기본 용역) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 4가지입니다. 물품 = 물품 구매·납품 입찰 공고만 조회하는 값입니다. 공사 = 공사 도급 입찰 공고만 조회하는 값입니다. 용역 = 용역·서비스 입찰 공고만 조회하는 값입니다. 외자 = 외자(해외 조달) 입찰 공고만 조회하는 값입니다. (string)","enum":["물품","공사","용역","외자"],"example":"공사"},"startDate":{"type":"string","description":"조회 시작일 (YYYYMMDD 또는 YYYYMMDDHHMM) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"20260901"},"endDate":{"type":"string","description":"조회 종료일 (YYYYMMDD 또는 YYYYMMDDHHMM) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"20260930"},"bidNtceNo":{"type":"string","description":"입찰공고번호 (지정 시 공고번호로 조회) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"indstrytyCd":{"type":"string","description":"업종코드 (선택) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"pageNo":{"type":"string","description":"페이지 번호 (기본 1) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)"},"numOfRows":{"type":"string","description":"페이지당 결과 수 (기본 10, 최대 999) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)","example":"200"}}}}}}}}},"x-code-tables":[{"title":"bizType 허용값","columns":["값","의미"],"rows":[["물품 (또는 goods)","물품 구매 낙찰 결과"],["공사 (또는 construction)","시설·건설 공사 낙찰 결과"],["용역 (또는 service)","용역 낙찰 결과 (기본값)"],["외자 (또는 foreign)","외자(해외 구매) 낙찰 결과"]]},{"title":"오류와 복구","columns":["상황","HTTP","data.error","해결"],"rows":[["업무구분 값 오류","400","업무구분이 잘못됐습니다(물품·공사·용역·외자).","bizType을 허용값 중 하나로 보내거나 생략합니다."],["입찰공고번호 형식 오류","400","bidNtceNo는 숫자를 포함한 영문·숫자 1~20자 문자열이어야 하며, 공백·구분자·공고차수는 허용하지 않습니다.","하이픈·공백·차수(-000 등)를 떼고 영문·숫자만 보냅니다."],["시작일 형식 오류","400","조회 시작일 형식이 잘못됐습니다.","YYYYMMDD 또는 YYYYMMDDHHMM으로 보냅니다."],["종료일 형식 오류","400","조회 종료일 형식이 잘못됐습니다.","YYYYMMDD 또는 YYYYMMDDHHMM으로 보냅니다."],["시작일이 종료일보다 늦음","400","조회 기간이 잘못됐습니다.","두 날짜의 순서를 바로잡습니다."],["기간 31일 초과","400","조회 기간은 최대 31일입니다.","기간을 31일 이하로 나눠 여러 번 조회합니다."],["날짜 한쪽만 보냄","400","조회 시작일과 종료일을 함께 입력해 주세요.","startDate와 endDate를 함께 보냅니다."],["기간·공고번호 모두 없음","400","조회 기간 또는 입찰공고번호가 필요합니다.","기간 두 날짜 또는 bidNtceNo를 보냅니다."],["일시적 조회 실패","424","입찰 정보를 가져오지 못했습니다.","잠시 후 같은 요청을 다시 보냅니다."],["포인트 부족","402","결제 금액보다 보유 포인트이 부족합니다.","포인트를 충전한 뒤 다시 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}