トップページ > ― 外部提供インタフェース(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備考
検索用APISRUURLXML(RDF)https://kn.ndl.go.jp/api/sruひなぎくの簡易検索画面及び詳細検索画面からの検索と同じ検索が行えます。
検索用APIOpenSearchURLXML(RSS)https://kn.ndl.go.jp/api/opensearch
ハーベスト用APIOAI-PMHURLXMLhttps://kn.ndl.go.jp/api/oaipmh
各プロトコルの詳細は、プロトコル名のリンク先ページをご覧ください。

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

2.1. 提供データ

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

2.2. メタデータの形式

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

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

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

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

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

2023年8月18日時点(リポジトリID順)
リポジトリID提供元メタデータの提供者メタデータ二次利用条件(○は申請不要。×は利用不可)
非営利目的営利目的
R200000002国立国会図書館蔵書当館
R200000004国立国会図書館雑誌記事索引当館
R200000007カレントアウェアネス・ポータル (国立国会図書館)当館要申請
R200100039国立国会図書館デジタルコレクション当館要申請
R200200001その他提供元 (個人)当館
R200200004日本原子力研究開発機構図書館蔵書他機関
R200200006国立国会図書館インターネット資料収集保存事業 (WARP)当館
R200200015国会事故調 (東京電力福島原子力発電所事故調査委員会)当館
R200200017ジャパン・プラットフォーム (JPF)当館
R200200018ジュピター テレコム (J:COM)当館
R200200020東京製本倶楽部当館
R200200022東京電力ホールディングス当館
R200200024国際協力NGOセンター (JANIC)当館
R200200027その他提供元 (団体)当館
R200200028国際交流基金当館
R200200029東日本激災復興新聞 (日本建設新聞社)当館
R200200030被災地斜め航空写真 (朝日航洋)当館
R200200031東日本大震災の記録 (学校法人東北学院)他機関
R200200033NWEC災害復興支援女性アーカイブ (国立女性教育会館)他機関
R200200039福島県新地町被災写真 (新地町図書館)当館
R200200040ICT地域の絆保存プロジェクト「東日本大震災を語り継ぐ」 (東松島市図書館)当館
R200200041国立国会図書館当館
R200200043青森震災アーカイブ他機関
R200200044市町村史に記された地震の記録 (埼玉県立熊谷図書館)他機関
R200200045わかりやすいプロジェクト 国会事故調編他機関
R200200046土木学会東日本大震災アーカイブサイト他機関
R200200047原子力規制委員会当館
R200200048日本財団当館
R2002000493がつ11にちをわすれないためにセンター (せんだいメディアテーク)他機関
R200200050政府インターネットテレビ当館
R200200051防災専門図書館蔵書 (全国市有物件災害共済会)他機関
R200200052国土地理院当館
R200200053長岡市災害復興文庫 (長岡市歴史文書館)他機関
R200200058環境省当館
R200200059防衛省当館
R200200060福島原子力事故関連情報アーカイブ (日本原子力研究開発機構)他機関
R200200061東日本大震災アーカイブ宮城他機関
R200200062郡山震災アーカイブ他機関
R200200064防災科学技術研究所自然災害情報室当館
R200200067浦安震災アーカイブ (浦安市立図書館)他機関
R200200068防災科学技術研究所自然災害情報室蔵書目録他機関
R200200069東海新報 (東海新報社)当館
R200200070災害撮影 [事業活動と社会貢献] (株式会社パスコ)当館
R200200072邑計画事務所当館
R200200073大槌町水道事業所当館
R200200074高田自動車学校当館
R200200076〈盛岡〉設計同人当館
R200200077厚生労働省当館
R200200078原子力規制委員会 (東京電力福島第一原子力発電所事故情報に係るアーカイブ)当館
R200200079国際航業当館
R200200080首相官邸当館
R200200081みえ防災・減災アーカイブ (三重県・三重大学 みえ防災・減災センター)他機関
R200200082写真企画当館
R200200083長岡市歴史文書館当館
R200200084共同通信社当館
R200200086いわて震災津波アーカイブ~希望~他機関
R200200087味の素当館
R200200088宮城県図書館当館
R200200089岩手県立図書館当館
R200200095熊本災害デジタルアーカイブ他機関
R200200096内閣府当館
R200200097岩手県の自然災害と東日本大震災に関する資料リポジトリ (岩手大学)他機関
R200200098復興庁当館
R200200099岩手未来機構当館
R2002001003.11いわてNPOチラシアーカイブ (いわて連携復興センター)他機関
R200200102国立国会図書館収集震災関係チラシ等当館
R200200103震災ライブラリーオンライン版 (東北大学附属図書館)他機関
R200200104石巻市復興を考える市民の会当館
R200200105災害写真データベース(消防防災科学センター)他機関
R200200107赤十字原子力災害情報センター デジタルアーカイブ(承継)他機関×
R200200108人と防災未来センター 資料室他機関
R200200112いま私たち市民にできることプロジェクト当館
R2002001182014年神城断層地震震災アーカイブ他機関



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