[나라장터 입찰공고 검색기 #1] 공공데이터 포털 API 신청 및 인증키 발급 가이드

지난번에 PDF 이미지 변환기를 만들며 자동화의 맛을 살짝 봤는데요. 오늘은 좀 더 실무적이고 강력한 도구를 만들어보려 합니다. 바로 ‘나라장터 입찰공고 검색기’입니다.

사업을 하시는 분들이나 관련 업무를 하시는 분들은 매일 나라장터에 접속해서 일일이 공고를 확인하는 게 얼마나 번거로운 일인지 잘 아실 거예요. 이 과정을 파이썬으로 자동화하기 위한 첫 번째 단추, 공공데이터 포털 API 활용 신청 방법을 아주 상세하게 정리해 드립니다.

1. 공공데이터 API, 왜 필요한가요?

단순히 웹사이트를 화면에서 보는 것과 ‘API’를 이용하는 것은 큰 차이가 있습니다. API를 이용하면 우리가 직접 사이트에 들어가지 않아도, 프로그램이 알아서 최신 공고 데이터를 싹 긁어올 수 있기 때문이죠.

우리가 활용할 데이터는 조달청에서 제공하는 “조달청_나라장터 입찰공고정보 서비스”입니다. 이 데이터를 얻기 위해 ‘공공데이터 포털’이라는 관문을 먼저 통과해야 합니다.

2. 공공데이터 포털 API 신청 단계별 따라하기

STEP 1: 회원가입 및 로그인

가장 먼저 공공데이터포털(data.go.kr)에 접속합니다. 아이디가 없으시다면 회원가입을 먼저 진행해 주세요. 국가에서 운영하는 포털이라 본인 인증 절차가 필수입니다.

STEP 2: 데이터 검색 및 오픈 API 선택

로그인을 하셨다면 메인 페이지 검색창에 “나라장터 입찰공고”라고 입력합니다. 검색 결과가 나오면 상단 탭에서 반드시 [오픈 API] 탭을 클릭해 주세요. 우리가 필요한 건 엑셀 파일이 아니라 실시간으로 소통할 ‘데이터 통로’니까요.

STEP 3: 조달청 서비스 선택 및 활용신청

리스트에서 “조달청_나라장터 입찰공고정보 서비스”를 찾아 클릭합니다. 상세 페이지로 이동하면 오른쪽 상단에 파란색 [활용신청] 버튼이 보일 거예요. 망설이지 말고 클릭하세요!

STEP 4: 활용 목적 기입 및 동의

신청 화면에서 몇 가지 정보를 입력해야 합니다.

동의 절차: 스크롤을 끝까지 내려 “동의합니다”에 체크한 후 최종 신청 버튼을 누릅니다.

활용 목적: “웹 사이트 개발” 혹은 “참고자료”를 선택하시면 됩니다.

상세 내용: “파이썬을 활용한 입찰공고 모니터링 프로그램 개발 및 업무 효율화” 정도로 간단히 적어주시면 충분합니다.

1. 공공데이터포털 회원가입하고 로그인을 합니다.
2. 검색창에 “나라장터 입찰공고”를 검색합니다.
3. 오픈 api를 클릭합니다.
4. “조달청_나라장터 입찰공고정보 서비스”를 클릭합니다.
5. 활용신청을 클릭합니다.
6. 활용목적을 기입하고 스크롤을 아래로 내려서 “동의합니다” 체크 후 활용신청을 클릭합니다.

3. 인증키(Service Key) 확인 시 주의사항

신청을 완료하면 바로 ‘마이페이지 > 오픈API > 활용신청 현황’에서 내가 신청한 목록을 볼 수 있습니다. 여기서 가장 중요한 것이 바로 ‘인증키(Service Key)’입니다.

⚠️ 여기서 잠깐! 삽질 방지 팁 인증키는 **일반 인증키(Encoding)**와 일반 인증키(Decoding) 두 가지가 있습니다. 파이썬 코드를 짤 때 어떤 키를 넣느냐에 따라 에러가 발생할 수 있는데요. 보통은 Decoding 키를 먼저 사용해보고, 안 되면 Encoding 키를 사용해 보는 것이 국룰(?)입니다. 이 부분은 다음 포스팅 코드 작성 편에서 더 자세히 다뤄볼게요.