Back to top

青空文庫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
HideShow
作品名
string (optional) Example: 走れメロス

検索対象カラムを指定して、完全一致で検索できます。また「作品名」カラムのみ作品名=/走れ/とすることでLIKE検索可能です。

limit
integer (optional) Example: 10

取得件数(max50)

after
string (optional) Example: 100-10

ページングは、after または beforeで「累計アクセス数-作品ID」のオフセットを指定。Responseにこの値が付与されたlinksが返ってくるので、手動で計算する必要はありません。

Request
HideShow
Headers
Content-Type: plain/text
Response  200
HideShow
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
HideShow
id
integer (required) Example: 10

作品ID

Request
HideShow
Headers
Content-Type: plain/text
Response  200
HideShow
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
HideShow
姓名
string (optional) Example: 太宰治

検索対象カラムを指定して、完全一致で検索できます。また「姓名」カラムのみ姓名=/芥川/とすることでLIKE検索可能です。

limit
integer (optional) Example: 10

取得件数(max50)

after
integer (optional) Example: 100

ページングは、after または beforeで「人物ID」のオフセットを指定。Responseにこの値が付与されたlinksが返ってくるので、手動で計算する必要はありません。

Request
HideShow
Headers
Content-Type: plain/text
Response  200
HideShow
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
HideShow
id
integer (required) Example: 10

人物ID

Request
HideShow
Headers
Content-Type: application/json
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "person": {
    "生年月日": "1904-12-28",
    "姓ローマ字": "Hori",
    "": "堀",
    "没年月日": "1953-05-28",
    "姓読みソート用": "ほり",
    "姓読み": "ほり",
    "名読みソート用": "たつお",
    "名読み": "たつお",
    "名ローマ字": "Tatsuo",
    "": "辰雄",
    "人物ID": "1030",
    "姓名": "堀辰雄",
    "人物著作権フラグ": "なし"
  }
}

Generated by aglio on 29 Sep 2019