トップページ > ― 外部提供インタフェース(API)

― 外部提供インタフェース(API)


1. 国立国会図書館東日本大震災アーカイブ(愛称:ひなぎく)で提供するAPI

ひなぎくでは、検索用APIとハーベスト用APIの2種類のAPIを提供しており、「メタデータ取得可能な提供元一覧」の全ての提供元について、両方のAPIでメタデータを取得することできます。

APIを利用される前に、必ず、「API利用申請について」をご一読ください。また、ひなぎく以外のサービスでAPIのご利用を希望される場合は、国立国会図書館ホームページ「APIの利用」をご覧ください。

1.1. 検索用API

ひなぎくの検索ができます。指定できる検索条件は、使用するAPIのプロトコルによって異なります。

SRU、OpenSearchに対応しています。

検索用APIを組み込むことにより検索窓等を作成することができます。

1.2. ハーベスト用API

ひなぎくに格納されたメタデータのダウンロードができます。

OAI-PMHで提供しています。

ひなぎくからメタデータをダウンロードし、他のシステムに取り込むこと等ができます。

※機能の一部でキャッシュ機能を用いているため、リクエスト条件やタイミングによって応答性能が大きく変わる場合があります。

1.3. APIの概要

各APIの概要は、下表のとおりです。概要表の詳細については、共通事項(PDFファイル)をご覧ください。


種別 プロトコル 入力形式 出力形式 アクセスURL 備考
検索用API SRU URL XML(RDF) https://kn.ndl.go.jp/api/sru ひなぎくの簡易検索画面及び詳細検索画面からの検索と同じ検索が行えます。
検索用API OpenSearch URL XML(RSS) https://kn.ndl.go.jp/api/opensearch
ハーベスト用API OAI-PMH URL XML https://kn.ndl.go.jp/api/oaipmh

各プロトコルの詳細は、プロトコル名のリンク先ページをご覧ください。


2. APIにより提供されるデータ

2.1. 提供データ

メタデータのみを提供しています。

2.2. メタデータの形式

ひなぎくが持つメタデータは、「国立国会図書館ダブリンコアメタデータ記述(DC-NDL)」を基に作成された「国立国会図書館東日本大震災アーカイブメタデータスキーマ」に従っています。

各プロトコルで返戻されるデータの形式も、「国立国会図書館東日本大震災アーカイブメタデータスキーマ」を基本形としています。

2.3. メタデータの更新時期

メタデータの更新は即時ではなく、日次のバッチ処理で更新されます。

このため、午前0時ちょうど(日付が変わった直後)にAPIを使用して、検索あるいはメタデータの収集を行った場合、前日のメタデータ更新が反映されていないメタデータが含まれる可能性があります。

2.4. メタデータ取得可能な提供元一覧

APIをご利用いただく際に、以下の提供元のリポジトリIDを指定することで検索対象を絞り込むことができます。全ての提供元について、検索用APIとハーベスト用APIの両方でメタデータを取得することできます。

各リポジトリの概要については、「検索対象データベース等一覧」をご覧ください。


国立国会図書館によるメタデータ提供(2024年7月12日時点)

リポジトリID 提供元 メタデータ二次利用条件(○は申請不要。×は利用不可)
非営利目的 営利目的
R200000002 国立国会図書館蔵書
R200000004 国立国会図書館雑誌記事索引
R200000007 カレントアウェアネス・ポータル (国立国会図書館) 要申請
R200100039 国立国会図書館デジタルコレクション 要申請
R200200001 その他提供元 (個人)
R200200006 国立国会図書館インターネット資料収集保存事業 (WARP)
R200200015 国会事故調 (東京電力福島原子力発電所事故調査委員会)
R200200017 ジャパン・プラットフォーム (JPF)
R200200018 ジュピター テレコム (J:COM)
R200200020 東京製本倶楽部
R200200022 東京電力ホールディングス
R200200024 国際協力NGOセンター (JANIC)
R200200027 その他提供元 (団体)
R200200028 国際交流基金
R200200029 東日本激災復興新聞 (日本建設新聞社)
R200200030 被災地斜め航空写真 (朝日航洋)
R200200039 福島県新地町被災写真 (新地町図書館)
R200200040 ICT地域の絆保存プロジェクト「東日本大震災を語り継ぐ」 (東松島市図書館)
R200200041 国立国会図書館
R200200047 原子力規制委員会
R200200048 日本財団
R200200050 政府インターネットテレビ
R200200052 国土地理院
R200200058 環境省
R200200059 防衛省
R200200064 防災科学技術研究所自然災害情報室
R200200069 東海新報 (東海新報社)
R200200070 災害撮影 [事業活動と社会貢献] (株式会社パスコ)
R200200072 邑計画事務所
R200200073 大槌町水道事業所
R200200074 高田自動車学校
R200200076 〈盛岡〉設計同人
R200200077 厚生労働省
R200200078 原子力規制委員会 (東京電力福島第一原子力発電所事故情報に係るアーカイブ)
R200200079 国際航業
R200200080 首相官邸
R200200082 写真企画
R200200083 長岡市歴史文書館
R200200084 共同通信社
R200200087 味の素
R200200088 宮城県図書館
R200200089 岩手県立図書館
R200200096 内閣府
R200200098 復興庁
R200200099 岩手未来機構
R200200102 国立国会図書館収集震災関係チラシ等
R200200104 石巻市復興を考える市民の会
R200200112 いま私たち市民にできることプロジェクト

他機関によるメタデータ提供(2024年7月12日時点)

リポジトリID 提供元 サイトポリシー
R200200004 日本原子力研究開発機構図書館蔵書 https://www.jaea.go.jp/policy.html
R200200031 東日本大震災の記録 (学校法人東北学院) https://www.tohoku-gakuin.jp/general/site_policy.html
R200200033 NWEC災害復興支援女性アーカイブ (国立女性教育会館) https://w-archive.nwec.go.jp/il/meta_pub/G0000337wd
R200200044 市町村史に記された地震の記録 (埼玉県立熊谷図書館) https://www.pref.saitama.lg.jp/a0301/tyosaku-rinku.html
R200200045 わかりやすいプロジェクト 国会事故調編
R200200046 土木学会東日本大震災アーカイブサイト https://www.jsce.or.jp/library/page/co.shtml
R200200049 3がつ11にちをわすれないためにセンター (せんだいメディアテーク) https://recorder311.smt.jp/use/
R200200051 防災専門図書館蔵書 (全国市有物件災害共済会)
R200200053 長岡市災害復興文庫 (長岡市歴史文書館)
R200200060 福島原子力事故関連情報アーカイブ (日本原子力研究開発機構) https://f-archive.jaea.go.jp/help.php?return=close#help2
R200200061 東日本大震災アーカイブ宮城 https://kioku.library.pref.miyagi.jp/ja-top-terms-of-use.html
R200200062 郡山震災アーカイブ https://www.city.koriyama.lg.jp/soshiki/5/7431.html
R200200067 浦安震災アーカイブ (浦安市立図書館)(承継)
R200200068 防災科学技術研究所自然災害情報室蔵書目録 https://www.bosai.go.jp/about/use.html
R200200081 みえ防災・減災アーカイブ (三重県・三重大学 みえ防災・減災センター) https://midori.midimic.jp/terms
R200200086 いわて震災津波アーカイブ~希望~ https://iwate-archive.pref.iwate.jp/terms/
R200200095 熊本災害デジタルアーカイブ https://www.kumamoto-archive.jp/about-us
R200200097 岩手県の自然災害と東日本大震災に関する資料リポジトリ (岩手大学) https://www.iwate-u.ac.jp/copyright.html
R200200100 3.11いわてNPOチラシアーカイブ (いわて連携復興センター) https://www.ifc.jp/page/wp/about
R200200103 震災ライブラリーオンライン版 (東北大学附属図書館) https://www.library.tohoku.ac.jp/copyright.html
R200200105 災害写真データベース(消防防災科学センター) https://www.saigaichousa-db-isad.jp/drsdb_photo/photoSearch.do
R200200107 赤十字原子力災害情報センター デジタルアーカイブ(承継)
R200200108 人と防災未来センター 資料室 https://www.dri.ne.jp/policy/
R200200113 青森震災アーカイブ(承継)
R200200118 2014年神城断層地震震災アーカイブ https://kamishiro.shinshu-bousai.jp/menu5/
R200200119 東日本大震災・原子力災害伝承館

最新のお知らせ



Copyright © 2013- National Diet Library. All Rights Reserved. 国立国会図書館 〒100-8924 東京都千代田区永田町1-10-1 電話:03-3581-2331(代表)