문화체육관광부 국립중앙도서관_주제 정보 제공 서비스

주제 정보 서비스는 국립중앙도서관의 주제명표목표(NLSH)를 핵심 데이터 기반으로 활용하여 구축된 표준화된 주제 접근점 제공 서비스입니다.NLSH는 자료의 주제 및 형식을 나타내는 용어와 그들 간의 계층적 관계를 포함한 관계 표기로 구성된 시소러스(통제어휘집)로서, 도서관 자료의 색인 및 검색 일관성을 확보하는 데 목적이 있습니다.주제 정보 서비스는 국제 표준인 SKOS(Simple Knowledge Organization System) 온톨로지 기반으로 설계되었으며, 이를 통해 우선어(USE), 비우선어(UF), 상위어(BT), 하위어(NT), 관련어(RT) 등의 항목을 제공합니다. 이러한 관계 정보를 활용하여 이용자는 검색 용어의 통일성을 확보할 수 있으며, 주제 간의 논리적 연계를 기반으로 검색 범위를 확장하거나 축소하는 정교한 탐색이 가능합니다. 나아가, 해당 주제에 연결된 서지정보와의 관계 정보까지 통합 조회할 수 있도록 지원함으로써, 도서관 및 아카이브 시스템 개발 시 자료 탐색의 정확성과 효율성을 획기적으로 향상시키는 데 기여합니다.

body header URI item items 개념체계 결과메세지 결과코드 관련어 국립중앙도서관제어번호_주제 데이터유형 동일개체 라벨 목록 건수 상위어 유사어 이전용어 이형표목 이후용어 정의 주제로 사용된 자료 참고링크 채택표목 총 개수 페이지 번호 하위어

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

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '결과 타입=json' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '제어번호=값' \
  --data-urlencode '주제명=값' \
  --data-urlencode '페이지번호=1' \
  --data-urlencode '한 페이지 결과 수=1'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "결과 타입": "json",
  "공공데이터포털에서 받은 인증키": "값",
  "제어번호": "값",
  "주제명": "값",
  "페이지번호": "1",
  "한 페이지 결과 수": "1",
});

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": "발급받은_인증키",
    "결과 타입": "json",
    "공공데이터포털에서 받은 인증키": "값",
    "제어번호": "값",
    "주제명": "값",
    "페이지번호": "1",
    "한 페이지 결과 수": "1",
}

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