나라장터 입찰공고를 키워드·기간·기관·지역·업종·추정가격으로 검색한다. 조건에 맞는 공고 목록을 찾을 때 쓴다. 공고번호를 이미 아는 단건 상세는 get_bid_notice를 쓴다. 업무구분 미지정 시 기타(etc) 제외 4구분(공사/용역/물품/외자)을 병렬 검색하며(API 요청 4건 소모, 구분을 알면 bidKind 지정), 기타공고 조회는 bidKind에 etc를 명시한다.

입찰공고번호로 단건 공고의 상세를 조회한다. 공고번호를 이미 알 때 쓴다. 조건으로 공고를 찾을 때는 search_bid_notices를 쓴다. 업무구분을 지정하면 해당 구분만, 미지정 시 기타(etc) 제외 4구분(공사/용역/물품/외자)을 차례로 조회하며(API 요청 최대 4건, 구분을 알면 지정), 기타공고 조회는 bidKind에 etc를 명시한다.

입찰공고번호로 기초금액·평가기준금액·예비가격범위율을 조회한다. 예정가격 산정의 기준값이 필요할 때 쓴다. 산식A 합산항목·평가주력분야는 get_bid_evaluation, 참가자격은 get_bid_eligibility를 쓴다. 기초금액은 물품·공사·용역 3구분만 존재하며(외자·기타 없음), bidKind 지정 시 해당 구분만(요청 1건), 미지정 시 3구분을 병렬 조회한다(요청 3건).

입찰공고번호로 낙찰가 산정 산식A(국민연금·건강보험료 등 합산항목)와 평가대상 주력분야를 조회한다. 예정가격결정방법과 항목별 금액이 필요할 때 쓴다. 기초금액은 get_bid_basis_amount, 참가자격은 get_bid_eligibility, 변경이력은 get_bid_change_history를 쓴다. 업무구분 구분 없이 단일 조회하며, 결과는 priceFormula(산식A)·targetField(평가주력분야) 두 키로 구분된다.

입찰공고번호로 공고의 변경이력(정정·변경 항목, 변경 전/후 값)을 조회한다. 공고 내용이 사후에 어떻게 바뀌었는지 확인할 때 쓴다. 기초금액은 get_bid_basis_amount, 참가자격은 get_bid_eligibility를 쓴다. 변경이력은 물품·공사·용역 3구분만 존재하며(외자·기타 없음), bidKind 지정 시 해당 구분만(요청 1건), 미지정 시 3구분을 병렬 조회한다(요청 3건). 변경 이력이 없는 공고는 빈 결과를 반환한다.

입찰공고번호와 공고차수로 면허제한과 참가가능지역을 조회한다. 투찰 가능 여부(면허·지역 조건)를 확인할 때 쓴다. 기초금액은 get_bid_basis_amount, 변경이력은 get_bid_change_history를 쓴다. 면허제한·참가가능지역은 공고차수(bidNtceOrd) 단위로 갈리므로 get_bid_notice 결과의 bidNtceOrd를 넘겨야 정확하며, 미지정 시 000(최초 차수)으로 조회한다.

입찰공고번호와 공고차수로 구매대상물품(품명·수량·단가·납품장소 등)을 조회한다. 공고에 포함된 물품 내역이 필요할 때 쓴다. 기초금액은 get_bid_basis_amount, 참가자격은 get_bid_eligibility를 쓴다. 구매대상물품은 물품·용역·외자 3구분만 존재하며(공사는 없음), bidKind 지정 시 해당 구분만(요청 1건), 미지정 시 3구분을 병렬 조회한다(요청 3건). 차수(bidNtceOrd)는 get_bid_notice에서 확인해 넘기며, 미지정 시 000으로 조회한다.

입찰공고번호로 그 공고의 첨부파일 파일명·다운로드 URL을 조회한다. 공고 본문 규격첨부(공고문·규격서·제안요청서·과업지시서 등)를 주 소스로, e발주·혁신장터RFP 첨부를 함께 반환한다(results.notice·eorder·innovationRfp). 첨부의 URL만 필요할 때 쓴다. 파일을 내려받아 목록(매니페스트)을 얻으려면 download_attachments를, 특정 파일의 본문 텍스트를 읽으려면 read_attachment를 쓴다. 기초금액·참가자격 등 다른 세부정보는 get_bid_basis_amount·get_bid_eligibility를 쓴다. 파일 자체는 내려받지 않고 URL만 반환한다. 한 호출이 공고 구분 해소(최대 5건)와 첨부 오퍼레이션 2건, 합계 최대 7건의 API 요청을 소모한다.

입찰공고 첨부를 전부 디스크에 내려받고 ZIP은 풀어(원본 ZIP은 지운다), 읽을 수 있는 파일 목록(카탈로그)만 반환한다(본문 텍스트는 담지 않는다). 각 파일 본문은 read_attachment에 이 목록의 index를 줘서 읽는다(불필요한 재조회 없이 필요한 파일만 읽는다). ZIP은 목록에서 사라지고 내부 파일이 공고 폴더에 평탄하게 풀려 항목으로 나오며 container에 원본 ZIP명이 담긴다. 첨부의 URL만 필요하면 get_bid_attachments를 쓴다. 저장 위치는 DATA_GO_KR_DOWNLOAD_DIR(미설정 시 ~/Downloads) 아래 공고번호 폴더다. 첨부가 나중에 바뀌면 refresh=true로 다시 호출한다. 각 항목의 extractable=true면 read_attachment로 본문(HWPX·구형 HWP·구형 DOC)을 읽을 수 있고, false면 파일만 저장돼 있어 savedPath로 직접 열어야 한다.

download_attachments가 준 파일 목록에서 index로 파일 하나를 골라 본문 텍스트를 읽는다. HWPX·구형 HWP·구형 DOC만 추출하며(그 외 format은 extractable=false라 본문이 비고 savedPath로 직접 열어야 한다), ZIP 내부 파일도 index로 직접 읽는다(container에 원본 ZIP명). 긴 문서는 offset·maxChars로 이어 읽는다(truncated=true면 다음 구간이 남음). 목록을 먼저 받으려면 download_attachments를, 첨부 URL만 필요하면 get_bid_attachments를 쓴다. 이미 내려받은 파일은 디스크에서 재사용한다(목록이 없으면 자동으로 먼저 내려받는다).