{"openapi":"3.0.3","info":{"title":"APICK 입찰 기회 분석","version":"1.0.0","description":"업무구분·조회 기간·입찰공고번호로 공공기관 입찰공고를 모아 예산구간·발주기관·업종·계약방법 분포, 마감 임박 공고, 예산 상위 공고를 분석합니다. 공고 원문 목록 대신 바로 쓸 수 있는 집계와 판단용 목록을 돌려줍니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/bid_notice":{"post":{"summary":"입찰 기회 분석","description":"업무구분·조회 기간·입찰공고번호로 공공기관 입찰공고를 모아 예산구간·발주기관·업종·계약방법 분포, 마감 임박 공고, 예산 상위 공고를 분석합니다. 공고 원문 목록 대신 바로 쓸 수 있는 집계와 판단용 목록을 돌려줍니다.","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":"분석한 공고 수입니다. 요청한 페이지의 공고 수와 같습니다."},"agency_count":{"type":"integer","description":"서로 다른 발주기관 수입니다."},"industry_count":{"type":"integer","description":"서로 다른 업종 수입니다."},"budget_total":{"type":"integer","description":"예산(추정가격)을 알 수 있는 공고의 예산 합계(원)입니다. 예산을 아는 공고가 없으면 null입니다.","nullable":true},"budget_median":{"type":"integer","description":"예산 중앙값(원, 정수 반올림)입니다. 예산을 아는 공고가 없으면 null입니다.","nullable":true},"closing_within_3d":{"type":"integer","description":"마감까지 0~3일 남은 공고 수입니다."},"closed":{"type":"integer","description":"마감일이 이미 지난 공고 수입니다."},"first_close_at":{"type":"string","description":"가장 이른 마감일(YYYY-MM-DD)입니다. 마감일을 아는 공고가 없으면 null입니다.","nullable":true},"last_close_at":{"type":"string","description":"가장 늦은 마감일(YYYY-MM-DD)입니다. 마감일을 아는 공고가 없으면 null입니다.","nullable":true}}},"distribution":{"type":"object","properties":{"by_agency":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"integer"}}},"description":"발주기관별 공고 수 상위 10곳입니다. 항목은 name·count·share_pct(전체 공고 대비 %, 소수 첫째 자리)입니다."},"by_industry":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"integer"}}},"description":"업종별 공고 수 상위 10개입니다. 항목 구성은 by_agency와 같습니다."},"by_method":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"integer"}}},"description":"계약방법별 공고 수 상위 5개입니다. 예: 일반경쟁, 제한경쟁"},"by_budget_band":{"type":"array","items":{"type":"object","properties":{"band":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"number"}}},"description":"예산 구간별 분포입니다. 항목은 band·count·share_pct이며 구간은 1억 미만·1~3억·3~10억·10~50억·50~100억·100~500억 순서로 0건이어도 모두 옵니다. 500억 원 이상 공고가 있을 때만 마지막 구간 500억 이상이 하나 더 붙습니다. share_pct는 예산을 아는 공고 대비 비율입니다."},"by_urgency":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"integer"}}},"description":"마감 긴급도별 분포입니다. name은 아래 urgency 값 중 하나입니다."}}},"deadlines":{"type":"array","items":{"type":"object","properties":{"bid_no":{"type":"string","description":"입찰공고번호입니다. 낙찰 결과를 추적할 때 bidNtceNo로 그대로 씁니다."},"bid_name":{"type":"string","description":"공고명입니다."},"agency":{"type":"string","description":"수요기관(없으면 공고기관) 이름입니다."},"notice_at":{"type":"string","description":"공고 게시 일시 문자열입니다. 예: 2026-10-16 09:00:00"},"close_at":{"type":"string","description":"입찰 마감 일시 문자열입니다. 예: 2026-10-24 10:00:00"},"days_left":{"type":"integer","description":"오늘(한국 시간)부터 마감일까지 남은 날 수입니다. 달력 날짜로 세어 마감 당일은 0, 다음 날 마감은 1이며 마감일을 알 수 없으면 null입니다.","nullable":true},"urgency":{"type":"string","description":"마감 긴급도입니다. 마감(지남)·마감임박(0~3일)·이번주(4~7일)·여유(8일 이상)·미상(마감일 없음)"},"budget":{"type":"integer","description":"예산(추정가격, 원)입니다. 알 수 없으면 null입니다.","nullable":true},"budget_band":{"type":"string","description":"예산 구간 이름입니다. 예산을 알 수 없으면 미상입니다."},"industry":{"type":"string","description":"업종 이름(없으면 업종코드)입니다. 없으면 빈 문자열입니다."},"method":{"type":"string","description":"계약방법입니다. 없으면 빈 문자열입니다."}}},"description":"아직 마감되지 않은 공고를 마감이 가까운 순서로 최대 10건 담습니다."},"largest":{"type":"array","items":{"type":"object","properties":{"bid_no":{"type":"string"},"bid_name":{"type":"string"},"agency":{"type":"string"},"notice_at":{"type":"string"},"close_at":{"type":"string"},"days_left":{"type":"integer"},"urgency":{"type":"string"},"budget":{"type":"integer"},"budget_band":{"type":"string"},"industry":{"type":"string"},"method":{"type":"string"}}},"description":"예산이 큰 순서로 최대 5건입니다. 마감이 지난 공고도 포함하며 항목 구성은 deadlines[]와 같습니다."},"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":"20261001"},"endDate":{"type":"string","description":"조회 종료일 (YYYYMMDD 또는 YYYYMMDDHHMM) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"20261007"},"bidNtceNo":{"type":"string","description":"입찰공고번호 (지정 시 공고번호로 조회) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"indstrytyCd":{"type":"string","description":"업종코드 (선택) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"pageNo":{"type":"string","description":"페이지 번호 (기본 1) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)"},"numOfRows":{"type":"string","description":"페이지당 결과 수 (기본 10, 최대 999) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)","example":"20"}}}}}}}}},"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"}}}}