행정안전부 한국지역정보개발원_(전국 통합데이터) 공공도서관 열람실 현황 실시간 정보

자치단체에서 운영하고 있는 공공 도서관 열람실 이용자의 편의제공을 목적으로 공공 도서관 통합정보를 비롯해 공공도서관 상태정보, 공공도서관 열람실의 실시간 좌석이용 현황 정보를 제공 합니다. 제공되는 정보는 공공 도서관의 지리적 위치 및 연락처, 운영시간, 휴관일 정보 등 공공 도서관의 기본 정보인 "공공도서관 통합정보"와 공공도서관의 운영 상태 및 방문자수, 좌석사용율 등의 공공도서관 운영상태 정보인 "공공도서관 현황정보", 공공도서관의 열람실 정보 및 열람실 실시간 이용가능한 좌석 정보인 "공공도서관 열람실 실시간정보"를 제공합니다.

body header item 건물층설명(2층) 건축면적(4998) 결과메세지 결과메세지(NORMAL_SERVICE) 결과코드 결과코드(K0) 경도(127.2531348) 공공도서관도로명주소(경기도 광주시 문화로 82) 공공도서관명(광주시립도서관) 공공도서관아이디(PL00001) 공공도서관유형명(공공도서관) 공공도서관전화번호(031-760-5678) 공휴일운영시작시각(090000) 공휴일운영종료시각(180000) 금일방문자수(100) 금일사용좌석수(100) 대출가능도서자료수(2500) 대출가능일수(4) 도서자료수(50000) 부지면적(7726) 비도서자료수(400) 사용좌석수(9) 사이트URL주소(https://lib.gjcity.go.kr/center/index.do) 시군구명(광주시) 시도명(경기도) 연속간행물수(250) 열람실명(열람실2) 열람실번호(2) 열람실아이디(LIB01) 열람실유형명(일반) 예약가능여부(Y) 예약좌석수(2) 운영기관명(경기도 광주시청) 운영상태명(운영중) 위도(37.41063314) 이용가능열람실수(3) 잔여좌석수(50) 전체 결과 수(5000) 좌석사용률(120) 주말운영시작시각(090000) 주말운영종료시각(180000) 지방자치단체명(경기도 광주시) 지자체 코드(전북특별자치도 익산시 : 5214000000) 집계기준일자(20250318) 총좌석수(200) 총좌석수(59) 페이지번호(1) 평일운영시작시각(090000) 평일운영종료시각(180000) 한 페이지 결과 수(5) 현재방문자수(9) 휴관정보설명(월+법정공휴일)

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '시작일자=20260101' \
  --data-urlencode '요청파일 타입=json' \
  --data-urlencode '종료일자=20260101' \
  --data-urlencode '지자체코드(법정동코드=11110' \
  --data-urlencode '전북특별자치도 익산시 : 5214000000) ※ https://www.code.go.kr/stdcode/regCodeL.do 참조=11110'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "공공데이터포털에서 받은 인증키": "값",
  "시작일자": "20260101",
  "요청파일 타입": "json",
  "종료일자": "20260101",
  "지자체코드(법정동코드": "11110",
  "전북특별자치도 익산시 : 5214000000) ※ https://www.code.go.kr/stdcode/regCodeL.do 참조": "11110",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "공공데이터포털에서 받은 인증키": "값",
    "시작일자": "20260101",
    "요청파일 타입": "json",
    "종료일자": "20260101",
    "지자체코드(법정동코드": "11110",
    "전북특별자치도 익산시 : 5214000000) ※ https://www.code.go.kr/stdcode/regCodeL.do 참조": "11110",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())