국회예산정책처

Open API

가이드

2025. 12.

국회예산정책처

목 차

1. Open API 개요	3

1.1 Open API 정의	3

1.2 Open API 동작 원리	3

1.3 Open API 표	3

2. 국회예산정책처 보고서 조회 서비스	4

2.1 서비스 개요	4

2.2 출력 결과 필드	4

2.3 에러 메시지	5

3. 국회예산정책처 정기간행물 조회 서비스	6

2.1 서비스 개요	6

2.2 출력 결과 필드	6

2.3 에러 메시지	7

4. 국회예산정책처 채용정보 조회 서비스	8

2.1 서비스 개요	8

2.2 출력 결과 필드	8

2.3 에러 메시지	9

1. Open API 개요

1.1 Open API 정의

Open API란 일반적으로 웹 서비스(Web Services)형태로써 특정 기능 혹은 콘텐츠 서비스를 위해 외부에 접근 방법을 공개한 형태를 개방형 인터페이스(이하 Open API)라 합니다.

1.2 Open API 동작 원리

API의 동작 단계는 이용자 입장에서 요청(request)하는 단계와, 결과(response) 값을 받아 해석(parse)하는 단계로 구성됩니다.

이용자는 해당 Open API 주소 뒤에 매개변수 값을 붙이는 GET 방식 또는 페이지 폼 안의 변수에 대한 POST 전달 방식을 통하여 API 매개변수 값을 전달하고, 서버에서 처리 수행한 결과를 반환 받습니다.

- GET 방식 매개변수 구성 예시: URL?변수=변수값1&변수2=변수값2…..(‘&’ 표기로 변수 구분)

1.3 Open API 표

분류	API
자료검색	일반검색
	상세 정보 요청

2. 국회예산정책처 보고서 조회 서비스

2.1 서비스 개요

국가예산정책처 보고서 목록을 조회할 수 있는 기능을 제공합니다.

2.1.1 검색 요청URL(request url)

https://www.nabo.go.kr/api/v1/report.do

2.1.2 국가예산정책처 보고서 목록 요청 변수(request parameter)

NO	변수명	TYPE	값 설명
1	key	String(필수)	인증키
2	page	number	페이지 번호
3	size	number	페이지 사이즈(default:20)
4	scSort	String	[정렬(생략시: 등록일순)] pubDt (게시일), subj (제목)
5	scOrder	String	asc (오름차순), desc (내림차순)
6	scSw		검색어

Example1>검색어: ‘정보’

https://www.nabo.go.kr/api/v1/report.do?key=[인증키값]&page

=1&size=10&scSw=%EB%B3%B4%EA%B3%A0%EC%84%9C&scSort=subj&scOrder=desc

2.2 출력 결과 필드(response field)

2.2.1 국가예산정책처 보고서 출력 결과 필드(response field)

NO	결과	TYPE	설명
1	page	number	해당 페이지번호
2	size	number	해당 페이지 사이즈
3	total	number	전체 검색 수
4	subj	String	게시물 제목
5	cdNm	String	게시물 작성자 또는 작성과
6	pubDt	date	게시물 게시일
7	count	number	게시물 조회수
8	text	String	게시물 내용
9	detailUrl	String	게시물url
10	name	String	첨부파일명
11	url	String	첨부파일 다운로드url

2.3 에러 메시지

2.3.1 에러 메시지

코드명(영문)	코드설명
INVALID_KEY	API Key가 없거나 잘못되었습니다.
INVALID_KEY	유효하지 않은 API Key 입니다.
NOT_APPROVED	승인 상태가 아닙니다.
NOT_YET_VALID	사용 시작 전입니다.
EXPIRED	사용 기간이 만료되었습니다.

3. 국회예산정책처 정기간행물 조회 서비스

3.1 서비스 개요

국가예산정책처 정기간행물 목록을 조회할 수 있는 기능을 제공합니다.

3.1.1 검색 요청URL(request url)

https://www.nabo.go.kr/api/v1/periodical.do

3.1.2 국가예산정책처 정기간행물 목록 요청 변수(request parameter)

NO	변수명	TYPE	값 설명
1	key	String(필수)	인증키
2	page	number	페이지 번호
3	size	number	페이지 사이즈(default:20)
4	scSort	String	[정렬(생략시: 등록일순)] pubDt (게시일), subj (제목)
5	scOrder	String	asc (오름차순), desc (내림차순)
6	scSw		검색어

Example1>검색어: ‘정보’

https://www.nabo.go.kr/api/v1/periodical.do?key=[인증키값]&page

=1&size=10&sw=%EC%A0%95%EB%B3%B4&scSort=subj&scOrder=desc

3.2 출력 결과 필드(response field)

3.2.1 국가예산정책처 정기간행물 출력 결과 필드(response field)

NO	결과	TYPE	설명
1	page	number	해당 페이지번호
2	size	number	해당 페이지 사이즈
3	total	number	전체 검색 수
4	subj	String	게시물 제목
5	cdNm	String	게시물 작성자 또는 작성과
6	pubDt	date	게시물 게시일
7	count	number	게시물 조회수
8	text	String	게시물 내용
9	detailUrl	String	게시물url
10	name	String	첨부파일명
11	url	String	첨부파일 다운로드url

3.3 에러 메시지

3.3.1 에러 메시지

코드명(영문)	코드설명
INVALID_KEY	API Key가 없거나 잘못되었습니다.
INVALID_KEY	유효하지 않은 API Key 입니다.
NOT_APPROVED	승인 상태가 아닙니다.
NOT_YET_VALID	사용 시작 전입니다.
EXPIRED	사용 기간이 만료되었습니다.

4. 국회예산정책처 채용정보 조회 서비스

4.1 서비스 개요

국가예산정책처 채용정보 목록을 조회할 수 있는 기능을 제공합니다.

4.1.1 검색 요청URL(request url)

https://www.nabo.go.kr/api/v1/recruitments.do

4.1.2 국가예산정책처 채용정보 목록 요청 변수(request parameter)

NO	변수명	TYPE	값 설명
1	key	String(필수)	인증키
2	page	number	페이지번호
3	size	number	페이지사이즈(default:20)
4	scSort	String	[정렬(생략시: 등록일순)] pubDt (게시일), subj (제목)
5	scOrder	String	asc (오름차순), desc (내림차순)
6	scSw	String	검색어

Example1>검색어: ‘예산’

https://www.nabo.go.kr/api/v1/recruitments.do/api/v1/recruitments.do?key=[인증키값]&page=1&size=10&scSw=%EC%98%88%EC%82%B0&scSort=subj&scOrder=desc

4.2 출력 결과 필드(response field)

4.2.1 국가예산정책처 채용정보 출력 결과 필드(response field)

NO	결과	TYPE	설명
1	page	number	해당 페이지번호
2	size	number	해당 페이지 사이즈
3	total	number	전체 검색 수
4	subj	String	게시물 제목
5	cdNm	String	게시물 작성자 또는 작성과
6	pubDt	date	게시물 게시일
7	count	number	게시물 조회수
8	text	String	게시물 내용
9	detailUrl	String	게시물url
10	name	String	첨부파일명
11	url	String	첨부파일 다운로드url

4.3 에러 메시지

4.3.1 에러 메시지

코드명(영문)	코드설명
INVALID_KEY	API Key가 없거나 잘못되었습니다.
INVALID_KEY	유효하지 않은API Key 입니다.
NOT_APPROVED	승인 상태가 아닙니다.
NOT_YET_VALID	사용 시작 전입니다.
EXPIRED	사용 기간이 만료되었습니다.