이 누리집은 대한민국 공식 전자정부 누리집입니다.
신청·참여
활용방법
ISBN 서지정보 API Open API 가이드 다운받기
사용설명ISBN 서지정보 목록 정보
일반검색 요청 URL(request url)https://www.nl.go.kr/seoji/SearchApi.do
- 미납본 목록 (구:출판예정도서)
- https://www.nl.go.kr/seoji/SearchApi.do?deposit_yn=N
| NO | 요청변수 | 형식 | 설명 |
|---|---|---|---|
| 1 | cert_key | String(필수) |
인증키 |
| 2 | result_style | String(필수) |
결과 형식 (json,xml) |
| 3 | page_no | Integer(필수) |
현재 쪽번호(페이지 1부터 시작) |
| 4 | page_size | Integer(필수) |
쪽당 출력건수 |
| 5 | isbn | String |
ISBN |
| 6 | set_isbn | String |
SET ISBN |
| 7 | ebook_yn | String |
전자책여부 Y,N |
| 8 | title | String |
본표제 |
| 9 | start_publish_date | String |
발행예정일 시작(8자리, yyyymmdd) |
| 10 | end_publish_date | String |
발행예정일 끝(8자리, yyyymmdd) |
| 11 | cip_yn | String |
CIP 신청여부 Y,N |
| 12 | deposit_yn | String |
납본유무 Y, N |
| 13 | series_title | String |
총서명 |
| 14 | publisher | String |
발행처명 |
| 15 | author | String |
저자 |
| 16 | form | String |
형태사항 (종이책, 혼합자료, 전자책, 오디오북, 기타 전자출판물, 다양한 제본형태, 다양한 형식혼합 세트) |
| 17 | sort | String |
정렬 PUBLISH_PREDATE INPUT_DATE INDEX_TITLE INDEX_PUBLISHER |
| 18 | order_by | String |
정렬방식 ASC , DESC |
https://www.nl.go.kr/seoji/SearchApi.do?cert_key=[발급된키값]&result_style=json&page_no=1&page_size=10&start_publish_date=20220509&end_publish_date=20220509
출력 결과 항목| NO | 필드 | 값 | 설명 |
|---|---|---|---|
| 1 | PAGE_NO | String | 현재 쪽번호 |
| 2 | TOTAL_COUNT | String | 전체 출력수 |
| 3 | TITLE | String | 표제 |
| 4 | VOL | String | 권차 |
| 5 | SERIES_TITLE | String | 총서명 |
| 6 | SERIES_NO | String | 총서편차 |
| 7 | AUTHOR | String | 저자 |
| 8 | EA_ISBN | String | ISBN |
| 9 | EA_ADD_CODE | String | ISBN 부가기호 |
| 10 | SET_ISBN | String | 세트 ISBN |
| 11 | SET_ADD_CODE | String | 세트 ISBN 부가기호 |
| 12 | SET_EXPRESSION | String | 세트표현 (세트, 전2권.) |
| 13 | PUBLISHER | String | 발행처 |
| 14 | EDITION_STMT | String | 판사항 |
| 15 | PRE_PRICE | String | 예정가격 |
| 16 | KDC | String | 한국십진분류 (2020년 12월 31일 이후 데이터 제공불가) |
| 17 | DDC | String | 듀이십진분류 |
| 18 | PAGE | String | 페이지 |
| 19 | BOOK_SIZE | String | 책크기 |
| 20 | FORM | String | 발행제본형태 |
| 21 | PUBLISH_PREDATE | String | 출판예정일 |
| 22 | SUBJECT | String | 주제 (KDC 대분류) |
| 23 | EBOOK_YN | String | 전자책여부 (Y: 전자책, N : 인쇄책) |
| 24 | CIP_YN | String | CIP 신청여부 (Y: CIP신청, N: CIP신청안함) |
| 25 | CONTROL_NO | String | CIP 제어번호 |
| 26 | TITLE_URL | String | 표지이미지 URL |
| 27 | BOOK_TB_CNT_URL | String | 목차 |
| 28 | BOOK_INTRODUCTION_URL | String | 책소개 |
| 29 | BOOK_SUMMARY_URL | String | 책요약 |
| 30 | PUBLISHER_URL | String | 출판사 홈페이지 URL |
| 31 | INPUT_DATE | String | 등록날짜 |
| 32 | UPDATE_DATE | String | 수정날짜 |
※ 제공서비스에 따라 출력결과 필드는 제한될 수 있습니다.
에러 메시지| 에러코드 | 설명 |
|---|---|
| 000 | 시스템 오류 |
| 010 | 인증키값 누락 |
| 011 | 유효하지않은 인증키 |
| 012 | 필수 파라메터 입력 누락 |
