개찰결과 검색
search_openingsRead-only
Search Korean public procurement opening results and filter by status (open completed, no bid, re-bid) to discover no-bid or re-bid notices.
Instructions
나라장터 개찰결과 목록을 검색하고 진행상태(개찰완료/유찰/재입찰)로 필터한다. 유찰·재입찰 공고 발굴에 쓴다. 최종낙찰자 검색은 search_awards, 단일 공고 상세는 get_bid_result를 쓴다. status는 API가 아니라 응답 기준 클라이언트 필터라 응답이 느리니 기관·업종·기간으로 좁혀 쓴다(truncated=true면 미완 스캔). 업무구분 미지정 시 전 구분 병렬 조회로 API 요청이 업무구분 수 × 기간창 수 × 페이지 수로 늘어난다(구분·기간을 좁혀 트래픽 절약). 재입찰은 동일 공고 내 재입찰이며 재공고가 아니다(재공고는 입찰공고 서비스 소관).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | 참가제한지역명(prtcptLmtRgnNm, 예: 인천광역시) | |
| status | No | 진행상태 필터(응답 progrsDivCdNm 기준 클라이언트 필터) | |
| bidKind | No | 업무구분 배열(cnstwk=공사·servc=용역·thng=물품·frgcpt=외자). 미지정 시 전 구분 병렬 조회로 API 요청이 4배로 늘어난다. 업무구분을 알면 지정해 인증키 일일 트래픽을 아낀다 | |
| endDate | No | 조회 종료일 YYYYMMDD (startDate와 함께 지정) | |
| keyword | No | 공고명(bidNtceNm) | |
| dateType | No | 날짜 기준: posted=공고게시(기본), opened=개찰 | |
| industry | No | 업종명(indstrytyNm) | |
| maxPages | No | 창당 최대 페이지(기본 5) | |
| pageSize | No | 창당 페이지 크기(기본 20, 개찰결과는 느려 작게 권장) | |
| startDate | No | 조회 시작일 YYYYMMDD (endDate와 함께 지정) | |
| institution | No | 공고기관명 | |
| demandInstitution | No | 수요기관명(dminsttNm) |