---
title: 도서관 정보나루 API 조사
date: 2026-03-15
description: 도서관 이름으로 위도/경도를 조회할 수 있는 data4library.kr 공공 API 조사 결과
---

# 도서관 정보나루 API 조사

국립중앙도서관이 운영하는 도서관 빅데이터 플랫폼으로, 1,588개 도서관 / 1.98억 장서 / 4천만 회원 / 24억 대출 기록을 보유하고 있다.

- Base URL: `http://data4library.kr/api/`
- 공식 사이트: https://www.data4library.kr/

## 도서관 위치 조회 — `/api/libSrch`

도서관 이름으로 검색하면 위도/경도를 바로 반환한다. 별도 지오코딩 서비스가 필요 없다.

```
GET http://data4library.kr/api/libSrch?authKey=YOUR_KEY&libName=판교&format=json
```

### 요청 파라미터

| 파라미터     | 필수 | 설명                         |
| ------------ | ---- | ---------------------------- |
| `authKey`    | O    | API 인증키                   |
| `libName`    | -    | 도서관 이름 (부분 검색 가능) |
| `region`     | -    | 지역 코드 (예: `11` = 서울)  |
| `dtl_region` | -    | 세부 지역 코드 (예: `11110`) |
| `format`     | -    | `json` 또는 XML (기본값)     |
| `pageNo`     | -    | 페이지 번호 (기본 1)         |
| `pageSize`   | -    | 페이지 크기 (기본 10)        |

### 응답 필드

| 필드            | 설명                      |
| --------------- | ------------------------- |
| `libCode`       | 도서관 코드 (고유 식별자) |
| `libName`       | 도서관 이름               |
| `address`       | 주소                      |
| `latitude`      | 위도                      |
| `longitude`     | 경도                      |
| `homepage`      | 홈페이지 URL              |
| `tel`           | 전화번호                  |
| `fax`           | 팩스                      |
| `closed`        | 휴관일                    |
| `operatingTime` | 운영시간                  |
| `BookCount`     | 장서 수                   |

### 응답 JSON 구조

```json
{
  "response": {
    "request": { ... },
    "resultNum": 3,
    "numFound": 3,
    "libs": [
      {
        "lib": {
          "libCode": "111016",
          "libName": "판교도서관",
          "address": "경기도 성남시 ...",
          "latitude": "37.xxxxx",
          "longitude": "127.xxxxx",
          "homepage": "https://...",
          "tel": "031-xxx-xxxx",
          "closed": "매주 월요일",
          "operatingTime": "09:00~18:00",
          "BookCount": "120000"
        }
      }
    ]
  }
}
```

## API 키 발급

1. https://data4library.kr/joinPage 에서 회원가입
2. 로그인 → 마이페이지 → **인증키** 메뉴
3. 이용 목적 선택, 개인정보 동의 후 신청
4. **다음 영업일 오전** 승인 완료
5. 승인 후 마이페이지에서 `authKey` 확인

문의처: libdata@korea.kr / 02-595-6131 (도서관 빅데이터 사무국)

## 호출 제한

| 구분             | 일일 호출 한도  |
| ---------------- | --------------- |
| 기본 (IP 미등록) | **500건/일**    |
| 서버 IP 등록 시  | **30,000건/일** |

- IP 등록: 마이페이지 → 인증키 관리 → 서버IP 입력
- 2023년 11월 20일부터 무제한 접근 중단, 최대 30,000건/일

## 기타 주요 엔드포인트

총 18개의 API 엔드포인트가 제공된다. 이 프로젝트에 유용한 항목:

| 엔드포인트               | 설명                                       |
| ------------------------ | ------------------------------------------ |
| `/api/libSrch`           | 도서관 검색 (위치, 연락처 등)              |
| `/api/extends/libSrch`   | 도서관 정보 + 대출 트렌드 통합             |
| `/api/bookExist`         | 특정 도서관의 도서 소장 여부 확인          |
| `/api/libSrchByBook`     | ISBN으로 소장 도서관 검색                  |
| `/api/srchBooks`         | 키워드로 도서 검색                         |
| `/api/srchDtlList`       | 도서 상세 정보 (서지, 표지, 대출 통계)     |
| `/api/loanItemSrch`      | 인기 대출 도서 (성별, 연령, 지역별 필터)   |
| `/api/hotTrend`          | 급상승 대출 도서 (7일 기준)                |
| `/api/usageAnalysisList` | 도서 이용 분석 (서지 + 대출 + 키워드 통합) |

## 이 프로젝트와의 연관성

- 현재 `LibraryInfo`는 `{ code, name }` 두 필드만 보유 — 좌표 정보 없음
- `/api/libSrch`로 190+개 도서관 좌표를 일괄 수집 가능 (500건/일이면 하루 완료)
- 한 번 수집한 좌표를 `LibraryInfo`에 캐싱하면 지도 기능 구현 가능
- `/api/bookExist`는 현재 프로젝트의 도서 소장 확인 기능과 유사
