青空文庫API - ZORAPI(ゾラピ)
青空文庫の作品データを検索できる非公式APIです。
取得できるすべてのデータはスプレッドシートで公開しているので、何ならこのシートをダウンロードしてご自由にお使いください。 https://docs.google.com/spreadsheets/d/1n04e6POI04TBt-3HJUH10-T5cxhPZHcBWmFA4tSHjqE/edit?usp=sharing
Books ¶
作品情報API
作品検索 ¶
作品検索GET/books?作品名=&limit={limit}&after={after}
検索条件に合致する作品を配列で返します。 検索可能なカラムは、スプレッドシートでオレンジ色になっているカラムです。
Example URI
GET https://api.bungomail.com/v0/books?作品名=&limit=10&after=100-10
URI Parameters
- 作品名
string
(optional) Example: 走れメロス検索対象カラムを指定して、完全一致で検索できます。また「作品名」カラムのみ
作品名=/走れ/
とすることでLIKE検索可能です。- limit
integer
(optional) Example: 10取得件数(max50)
- after
string
(optional) Example: 100-10ページングは、after または beforeで「累計アクセス数-作品ID」のオフセットを指定。Responseにこの値が付与されたlinksが返ってくるので、手動で計算する必要はありません。
Request
Headers
Content-Type: plain/text
Response
200
Headers
Content-Type: application/json
Body
{
"books": [
{
"作品ID": "1567",
"作品名": "走れメロス",
"底本出版社名2": "",
"図書カードURL": "https://www.aozora.gr.jp/cards/000035/card1567.html",
"底本出版社名1": "ちくま文庫、筑摩書房",
"XHTML/HTMLファイル修正回数": "1",
"作品名読み": "はしれメロス",
"底本初版発行年1": "1988(昭和63)年10月25日",
"人物著作権フラグ": "なし",
"校正に使用した版2": "",
"姓": "太宰",
"底本初版発行年2": "",
"公開日": "2000-12-04",
"名読み": "おさむ",
"XHTML/HTMLファイルURL": "https://www.aozora.gr.jp/cards/000035/files/1567_14913.html",
"底本名2": "",
"テキストファイル符号化方式": "ShiftJIS",
"テキストファイルURL": "https://www.aozora.gr.jp/cards/000035/files/1567_ruby_4948.zip",
"底本の親本出版社名1": "筑摩書房",
"人物ID": "35",
"底本の親本初版発行年2": "",
"副題": "",
"カテゴリ": "short",
"テキストファイル文字集合": "JIS X 0208",
"書き出し": "メロスは激怒した。",
"原題": "",
"XHTML/HTMLファイル符号化方式": "ShiftJIS",
"テキストファイル修正回数": "2",
"累計アクセス数": 1668185,
"姓ローマ字": "Dazai",
"最終更新日": "2014-09-17",
"没年月日": "1948-06-13",
"テキストファイル最終更新日": "2011-01-17",
"姓読み": "だざい",
"名ローマ字": "Osamu",
"名": "治",
"底本名1": "太宰治全集3",
"底本の親本初版発行年1": "1975(昭和50)年6月~1976(昭和51)年6月",
"底本の親本名2": "",
"底本の親本名1": "筑摩全集類聚版太宰治全集",
"校正者": "高橋美奈子",
"入力に使用した版1": "",
"姓読みソート用": "たさい",
"XHTML/HTMLファイル最終更新日": "2011-01-17",
"作品著作権フラグ": "なし",
"ソート用読み": "はしれめろす",
"入力に使用した版2": "",
"入力者": "金川一之",
"底本の親本出版社名2": "",
"副題読み": "",
"文字遣い種別": "新字新仮名",
"役割フラグ": "著者",
"姓名": "太宰治",
"文字数": 10344,
"分類番号": "NDC 913",
"XHTML/HTMLファイル文字集合": "JIS X 0208",
"初出": "",
"人物": {
"著者": {
"人物著作権フラグ": "なし",
"生年月日": "1909-06-19",
"姓ローマ字": "Dazai",
"姓": "太宰",
"没年月日": "1948-06-13",
"姓読みソート用": "たさい",
"姓読み": "だざい",
"名読みソート用": "おさむ",
"名読み": "おさむ",
"名ローマ字": "Osamu",
"名": "治",
"人物ID": "35",
"姓名": "太宰治"
}
},
"生年月日": "1909-06-19",
"校正に使用した版1": "1998(平成10)年6月15日第2刷",
"名読みソート用": "おさむ"
},
...
],
"links": {
"next": "https://api.bungomail.com/v0/books?after=277382,42286"
}
}
作品データ取得 ¶
作品データ取得GET/books/{id}
作品IDで指定した作品のデータを取得します。
Example URI
GET https://api.bungomail.com/v0/books/10
URI Parameters
- id
integer
(required) Example: 10作品ID
Request
Headers
Content-Type: plain/text
Response
200
Headers
Content-Type: application/json
Body
{
"book": {
"作品ID": "1567",
"作品名": "走れメロス",
"底本出版社名2": "",
"図書カードURL": "https://www.aozora.gr.jp/cards/000035/card1567.html",
"底本出版社名1": "ちくま文庫、筑摩書房",
"XHTML/HTMLファイル修正回数": "1",
"作品名読み": "はしれメロス",
"底本初版発行年1": "1988(昭和63)年10月25日",
"人物著作権フラグ": "なし",
"校正に使用した版2": "",
"姓": "太宰",
"底本初版発行年2": "",
"公開日": "2000-12-04",
"名読み": "おさむ",
"XHTML/HTMLファイルURL": "https://www.aozora.gr.jp/cards/000035/files/1567_14913.html",
"底本名2": "",
"テキストファイル符号化方式": "ShiftJIS",
"テキストファイルURL": "https://www.aozora.gr.jp/cards/000035/files/1567_ruby_4948.zip",
"底本の親本出版社名1": "筑摩書房",
"人物ID": "35",
"底本の親本初版発行年2": "",
"副題": "",
"カテゴリ": "short",
"テキストファイル文字集合": "JIS X 0208",
"書き出し": "メロスは激怒した。",
"原題": "",
"XHTML/HTMLファイル符号化方式": "ShiftJIS",
"テキストファイル修正回数": "2",
"累計アクセス数": 1668185,
"姓ローマ字": "Dazai",
"最終更新日": "2014-09-17",
"没年月日": "1948-06-13",
"テキストファイル最終更新日": "2011-01-17",
"姓読み": "だざい",
"名ローマ字": "Osamu",
"名": "治",
"底本名1": "太宰治全集3",
"底本の親本初版発行年1": "1975(昭和50)年6月~1976(昭和51)年6月",
"底本の親本名2": "",
"底本の親本名1": "筑摩全集類聚版太宰治全集",
"校正者": "高橋美奈子",
"入力に使用した版1": "",
"姓読みソート用": "たさい",
"XHTML/HTMLファイル最終更新日": "2011-01-17",
"作品著作権フラグ": "なし",
"ソート用読み": "はしれめろす",
"入力に使用した版2": "",
"入力者": "金川一之",
"底本の親本出版社名2": "",
"副題読み": "",
"文字遣い種別": "新字新仮名",
"役割フラグ": "著者",
"姓名": "太宰治",
"文字数": 10344,
"分類番号": "NDC 913",
"XHTML/HTMLファイル文字集合": "JIS X 0208",
"初出": "",
"人物": {
"著者": {
"人物著作権フラグ": "なし",
"生年月日": "1909-06-19",
"姓ローマ字": "Dazai",
"姓": "太宰",
"没年月日": "1948-06-13",
"姓読みソート用": "たさい",
"姓読み": "だざい",
"名読みソート用": "おさむ",
"名読み": "おさむ",
"名ローマ字": "Osamu",
"名": "治",
"人物ID": "35",
"姓名": "太宰治"
}
},
"生年月日": "1909-06-19",
"校正に使用した版1": "1998(平成10)年6月15日第2刷",
"名読みソート用": "おさむ"
}
}
Persons ¶
人物情報API
人物検索 ¶
人物検索GET/persons?姓名=&limit={limit}&after={after}
検索条件に合致する人物情報を配列で返します。 検索可能なカラムは、スプレッドシートでオレンジ色になっているカラムです。
Example URI
GET https://api.bungomail.com/v0/persons?姓名=&limit=10&after=100
URI Parameters
- 姓名
string
(optional) Example: 太宰治検索対象カラムを指定して、完全一致で検索できます。また「姓名」カラムのみ
姓名=/芥川/
とすることでLIKE検索可能です。- limit
integer
(optional) Example: 10取得件数(max50)
- after
integer
(optional) Example: 100ページングは、after または beforeで「人物ID」のオフセットを指定。Responseにこの値が付与されたlinksが返ってくるので、手動で計算する必要はありません。
Request
Headers
Content-Type: plain/text
Response
200
Headers
Content-Type: application/json
Body
{
"persons": [
{
"生年月日": "1904-12-28",
"姓ローマ字": "Hori",
"姓": "堀",
"没年月日": "1953-05-28",
"姓読みソート用": "ほり",
"姓読み": "ほり",
"名読みソート用": "たつお",
"名読み": "たつお",
"名ローマ字": "Tatsuo",
"名": "辰雄",
"人物ID": "1030",
"姓名": "堀辰雄",
"人物著作権フラグ": "なし"
},
],
"links": {
"next": "https://api.bungomail.com/v0/persons?after=1081"
}
}
人物データ取得 ¶
人物データ取得GET/persons/{id}
人物IDで指定した人物のデータを取得します。
Example URI
GET https://api.bungomail.com/v0/persons/10
URI Parameters
- id
integer
(required) Example: 10人物ID
Request
Headers
Content-Type: application/json
Response
200
Headers
Content-Type: application/json
Body
{
"person": {
"生年月日": "1904-12-28",
"姓ローマ字": "Hori",
"姓": "堀",
"没年月日": "1953-05-28",
"姓読みソート用": "ほり",
"姓読み": "ほり",
"名読みソート用": "たつお",
"名読み": "たつお",
"名ローマ字": "Tatsuo",
"名": "辰雄",
"人物ID": "1030",
"姓名": "堀辰雄",
"人物著作権フラグ": "なし"
}
}