조달청_나라장터 입찰공고정보서비스 이용

공공데이터포털의 나라장터 API로 입찰공고(용역)를 조회하는 주소(URL)를 만들어 봅니다. 아래 칸을 채우고 복사를 누른 뒤, 인터넷 창 주소창에 붙여 넣으면 결과를 볼 수 있습니다.

1. 조립된 URL

※ 이 페이지에서는 조회하지 않습니다(인증키 보안). 복사한 주소를 새 탭 주소창에 붙여 넣고 Enter를 누르세요.

2. Parameter 설명

이름뜻값
serviceKey 필수공공데이터포털에서 받은 인증키
마이페이지 → 활용신청 현황 → 일반 인증키(Encoding)
pageNo몇 번째 페이지1
numOfRows한 번에 가져올 건수5
type결과 형식 (json / xml)json
inqryDiv조회 구분 (1 = 공고 게시일시로 찾기)1
inqryBgnDt조회 시작일시 (년월일시분 12자리)
오늘 포함 7일 전으로 자동 설정
inqryEndDt조회 종료일시 (년월일시분 12자리)
오늘로 자동 설정 · 기간은 최대 7일
bidNtceNm공고명 키워드 (비우면 전체)

3. 결과 예시

✔ 성공했을 때

resultCode 가 "00", items 안에 공고가 보이면 성공입니다. (아래 값은 모양을 보여 주기 위한 예시입니다)

{
  "response": {
    "header": { "resultCode": "00", "resultMsg": "정상" },
    "body": {
      "items": [
        {
          "bidNtceNo": "R25BK00000000",
          "bidNtceNm": "○○시 정보시스템 유지보수 용역",
          "ntceInsttNm": "○○시",
          "dminsttNm": "○○시 정보통신과",
          "bidNtceDt": "2026-11-20 10:00:00",
          "bidClseDt": "2026-11-28 10:00:00",
          "bidNtceDtlUrl": "https://www.g2b.go.kr/..."
        }
      ],
      "numOfRows": 5, "pageNo": 1, "totalCount": 37
    }
  }
}
항목뜻
bidNtceNm공고명
ntceInsttNm공고 기관
dminsttNm수요 기관
bidNtceDt공고 일시
bidClseDt입찰 마감일시
bidNtceDtlUrl나라장터 원문 주소 (주소창에 붙여 넣으면 공고가 열림)
totalCount조건에 맞는 전체 공고 수
✘ 오류가 났을 때
화면에 나온 것뜻 · 할 일
SERVICE_KEY_IS_NOT_REGISTERED_ERROR (30)키가 아직 등록 전. 신청 직후면 1~2시간 뒤 다시. 계속되면 Decoding 키로 바꿔 보기
NO_OPENAPI_SERVICE_ERROR (12)주소 오타. 주소를 고치지 말고 이 페이지에서 다시 복사
resultCode "00" 인데 totalCount 0조건에 맞는 공고 없음. 키워드를 넓히기
{
  "OpenAPI_ServiceResponse": {
    "cmmMsgHeader": {
      "errMsg": "SERVICE_KEY_IS_NOT_REGISTERED_ERROR",
      "returnAuthMsg": "등록되지 않은 서비스키",
      "returnReasonCode": "30"
    }
  }
}