api
JSON
rest
RESTful
REST-API

アニソン情報を取得するRESTfulAPIを公開しました。2018-05-22更新

AnisonStationApiの公開

更新履歴

2018-05-20 楽曲データに関するAPIを追加
2018-05-21 歌手データに関するAPIを追加
       ID指定での問い合わせの際の応答結果の仕様変更
2018-05-22 ふと思い立ってLet's Encryptでssl通信対応

API使用上の注意

本API公開に当たって、AnisonGeneration様が公開されているcsvデータを使用しています。

  • 本APIのデータの二次利用につきましてはAnisonGeneration様の規約に従ってご利用ください。
  • AnisonGeneration様では、各種データを募集しています。ユーザー登録をすることで、各データの追加をすることができます。
  • データに誤りがある場合は、AnisonGeneration様情報修正掲示板へご連絡ください。

APIリファレンス

Endpoint

https://2ndrelaypumpstation.net/Api/v1

認証

v1では認証は行わない

API仕様概要

httpメソッド URL パラメータ Response内容
GET /Api/v1 なし READMEを応答する
GET /Api/v1/programs なし 直近で登録された番組データを200件応答する
GET /Api/v1/programs title={任意の文字列} パラメータで渡された任意の文字列が、titleに関連するデータ4つのいずれかと部分一致する番組データを応答する
GET /Api/v1/programs/{id} なし 該当するidの番組データと付随する楽曲データを応答する
GET /Api/v1/programs/tvanimes/{year} なし 該当する年に放送開始したTVアニメ一覧を応答する
GET /Api/v1/programs/tvanimes/{year}/{season_id} なし 該当するクールに放送開始したTVアニメ一覧を応答する。season_idは1:冬、2.春、3.夏、4.秋
GET /Api/v1/songs なし 直近で登録された楽曲データを200件応答する
GET /Api/v1/songs title={任意の文字列} パラメータで渡された任意の文字列が、titleと部分一致する楽曲データを10000件まで応答する
GET /Api/v1/songs/{id} なし 該当するidの楽曲データを応答する
GET /Api/v1/singers name={任意の文字列} パラメータで渡された任意の文字列が、nameと部分一致する歌手データを応答する
GET /Api/v1/singers/{id} なし 該当するidの歌手データと楽曲データを応答する

GET /Api/v1/programs

Response例


$ curl https://2ndrelaypumpstation.net/Api/v1/programs

[
    {
        "id": 14987,
        "title": "踏切時間",
        "kana_title": "フミキリジカン",
        "other_title_01": "",
        "other_title_02": "",
        "anisoninfo_program_id": 21081,
        "broadcast_start_on": "2018-04-10",
        "program_type": {
            "id": 2,
            "code": "TV",
            "name": "テレビアニメーション"
        },
        "game_genre": {
            "id": 1,
            "name": ""
        }
    },
    {
        "id": 12829,
        "title": "信長の忍び~姉川・石山篇~",
        "kana_title": "ノブナガノシノビアネガワイシヤマヘン",
        "other_title_01": "",
        "other_title_02": "",
        "anisoninfo_program_id": 21080,
        "broadcast_start_on": "2018-04-07",
        "program_type": {
            "id": 2,
            "code": "TV",
            "name": "テレビアニメーション"
        },
        "game_genre": {
            "id": 1,
            "name": ""
        }
    },

    //省略
]

GET /Api/v1/programs?title=任意の文字列

Response例

$ curl https://2ndrelaypumpstation.net/Api/v1/programs?title=steins

[
    {
        "id": 7590,
        "title": "Steins;Gate",
        "kana_title": "シュタインズゲート",
        "other_title_01": "",
        "other_title_02": "",
        "anisoninfo_program_id": 13401,
        "broadcast_start_on": "2011-04-06",
        "program_type": {
            "id": 2,
            "code": "TV",
            "name": "テレビアニメーション"
        },
        "game_genre": {
            "id": 1,
            "name": ""
        }
    },
    {
        "id": 7591,
        "title": "Steins;Gate",
        "kana_title": "シュタインズゲート",
        "other_title_01": "",
        "other_title_02": "",
        "anisoninfo_program_id": 11970,
        "broadcast_start_on": "2009-10-15",
        "program_type": {
            "id": 3,
            "code": "GM",
            "name": "ゲーム"
        },
        "game_genre": {
            "id": 6,
            "name": "アドベンチャー"
        }
    }

    //省略
]

GET /Api/v1/programs/{id}

Response例

$ curl https://2ndrelaypumpstation.net/Api/v1/programs/7590

{
    "id": 7590,
    "title": "Steins;Gate",
    "kana_title": "シュタインズゲート",
    "other_title_01": "",
    "other_title_02": "",
    "anisoninfo_program_id": 13401,
    "broadcast_start_on": "2011-04-06",
    "program_type": {
        "id": 2,
        "code": "TV",
        "name": "テレビアニメーション"
    },
    "game_genre": {
        "id": 1,
        "name": ""
    },
    "songs": [
        {
            "id": 23825,
            "title": "Hacking to the Gate",
            "anisoninfo_song_id": 67986,
            "song_role": {
                "id": 1,
                "code": "OP",
                "name": "オープニングテーマ"
            },
            "singer": {
                "id": 3363,
                "name": "いとうかなこ"
            }
        },
        {
            "id": 23829,
            "title": "Fake Verthandi",
            "anisoninfo_song_id": 70994,
            "song_role": {
                "id": 2,
                "code": "ED",
                "name": "エンディングテーマ"
            },
            "singer": {
                "id": 6,
                "name": "(インストゥルメンタル)"
            }
        },
        {
            "id": 23828,
            "title": "スカイクラッドの観測者",
            "anisoninfo_song_id": 59464,
            "song_role": {
                "id": 2,
                "code": "ED",
                "name": "エンディングテーマ"
            },
            "singer": {
                "id": 3363,
                "name": "いとうかなこ"
            }
        },
        {
            "id": 23830,
            "title": "Another Heaven",
            "anisoninfo_song_id": 59608,
            "song_role": {
                "id": 2,
                "code": "ED",
                "name": "エンディングテーマ"
            },
            "singer": {
                "id": 3363,
                "name": "いとうかなこ"
            }
        },
        {
            "id": 23827,
            "title": "刻司ル十二ノ盟約",
            "anisoninfo_song_id": 67989,
            "song_role": {
                "id": 2,
                "code": "ED",
                "name": "エンディングテーマ"
            },
            "singer": {
                "id": 4958,
                "name": "ファンタズム"
            }
        }
    ]
}


GET /Api/v1/programs/tvanimes/{year}

Response例

$ curl https://2ndrelaypumpstation.net/Api/v1/tvanimes/2017
[
    {
        "id": 151,
        "title": "ID-0",
        "kana_title": "アイディーゼロ",
        "other_title_01": "",
        "other_title_02": "",
        "anisoninfo_program_id": 20170,
        "broadcast_start_on": "2017-04-09",
        "program_type": {
            "id": 2,
            "code": "TV",
            "name": "テレビアニメーション"
        }
    },
    {
        "id": 176,
        "title": "アイドル事変",
        "kana_title": "アイドルジヘン",
        "other_title_01": "Idol Incidents",
        "other_title_02": "アイドルインシデンツ",
        "anisoninfo_program_id": 19800,
        "broadcast_start_on": "2017-01-08",
        "program_type": {
            "id": 2,
            "code": "TV",
            "name": "テレビアニメーション"
        }
    },
    //省略
]

GET /Api/v1/programs/tvanimes/{year}/{season_id}

Response例

$ curl https://2ndrelaypumpstation.net/Api/v1/programs/2018/1
[
    {
        "id": 165,
        "title": "アイドリッシュセブン",
        "kana_title": "アイドリッシュセブン",
        "other_title_01": "IDOLiSH7",
        "other_title_02": "アイドリッシュセブン",
        "anisoninfo_program_id": 20745,
        "broadcast_start_on": "2018-01-01",
        "program_type": {
            "id": 2,
            "code": "TV",
            "name": "テレビアニメーション"
        }
    },
    {
        "id": 1415,
        "title": "伊藤潤二『コレクション』",
        "kana_title": "イトウジュンジコレクション",
        "other_title_01": "",
        "other_title_02": "",
        "anisoninfo_program_id": 20829,
        "broadcast_start_on": "2018-01-05",
        "program_type": {
            "id": 2,
            "code": "TV",
            "name": "テレビアニメーション"
        }
    },
    //省略
]

GET /Api/v1/songs

Response例

$ curl https://2ndrelaypumpstation.net/Api/v1/songs

[
    {
        "id": 18027,
        "title": "キミガタメ Re:boot",
        "anisoninfo_song_id": 112650,
        "program": {
            "id": 1882,
            "title": "うたわれるもの~散りゆく者への子守唄~",
            "kana_title": "ウタワレルモノチリユクモノヘノコモリウタ",
            "other_title_01": "",
            "other_title_02": "",
            "anisoninfo_program_id": 8352,
            "broadcast_start_on": "2006-10-26",
            "program_type": {
                "id": 3,
                "code": "GM",
                "name": "ゲーム"
            }
        },
        "song_role": {
            "id": 2,
            "code": "ED",
            "name": "エンディングテーマ"
        },
        "singer": {
            "id": 3715,
            "name": "Suara"
        }
    },
    {
        "id": 18025,
        "title": "君だけの旅路 Re:boot",
        "anisoninfo_song_id": 112649,
        "program": {
            "id": 1882,
            "title": "うたわれるもの~散りゆく者への子守唄~",
            "kana_title": "ウタワレルモノチリユクモノヘノコモリウタ",
            "other_title_01": "",
            "other_title_02": "",
            "anisoninfo_program_id": 8352,
            "broadcast_start_on": "2006-10-26",
            "program_type": {
                "id": 3,
                "code": "GM",
                "name": "ゲーム"
            }
        },
        "song_role": {
            "id": 1,
            "code": "OP",
            "name": "オープニングテーマ"
        },
        "singer": {
            "id": 3715,
            "name": "Suara"
        }
    }
    //省略
]

GET /Api/v1/songs?title={任意の文字列}

Response例

$ curl https://2ndrelaypumpstation.net/Api/v1/songs?title=観測者

[
    {
        "id": 22133,
        "title": "スカイクラッドの観測者",
        "anisoninfo_song_id": 59464,
        "program": {
            "id": 7591,
            "title": "Steins;Gate",
            "kana_title": "シュタインズゲート",
            "other_title_01": "",
            "other_title_02": "",
            "anisoninfo_program_id": 11970,
            "broadcast_start_on": "2009-10-15",
            "program_type": {
                "id": 3,
                "code": "GM",
                "name": "ゲーム"
            }
        },
        "song_role": {
            "id": 1,
            "code": "OP",
            "name": "オープニングテーマ"
        },
        "singer": {
            "id": 3363,
            "name": "いとうかなこ"
        }
    },
    {
        "id": 23828,
        "title": "スカイクラッドの観測者",
        "anisoninfo_song_id": 59464,
        "program": {
            "id": 7590,
            "title": "Steins;Gate",
            "kana_title": "シュタインズゲート",
            "other_title_01": "",
            "other_title_02": "",
            "anisoninfo_program_id": 13401,
            "broadcast_start_on": "2011-04-06",
            "program_type": {
                "id": 2,
                "code": "TV",
                "name": "テレビアニメーション"
            }
        },
        "song_role": {
            "id": 2,
            "code": "ED",
            "name": "エンディングテーマ"
        },
        "singer": {
            "id": 3363,
            "name": "いとうかなこ"
        }
    }
]

GET /Api/v1/songs/{id}

Response例

$ curl https://2ndrelaypumpstation.net/Api/v1/songs/22133

{
    "id": 22133,
    "title": "スカイクラッドの観測者",
    "anisoninfo_song_id": 59464,
    "program": {
        "id": 7591,
        "title": "Steins;Gate",
        "kana_title": "シュタインズゲート",
        "other_title_01": "",
        "other_title_02": "",
        "anisoninfo_program_id": 11970,
        "broadcast_start_on": "2009-10-15",
        "program_type": {
            "id": 3,
            "code": "GM",
            "name": "ゲーム"
        }
    },
    "song_role": {
        "id": 1,
        "code": "OP",
        "name": "オープニングテーマ"
    },
    "singer": {
        "id": 3363,
        "name": "いとうかなこ"
    }
}

GET /Api/v1/singers?name={任意の文字列}

Response例


$ curl https://2ndrelaypumpstation.net/Api/v1/singers?name=いとうかなこ
[
    {
        "id": 3363,
        "name": "いとうかなこ"
    },
    {
        "id": 7535,
        "name": "栗林みな実,rino,yozuca*,いとうかなこ,マヨちゃん,ジョイまっくす"
    },
    {
        "id": 7552,
        "name": "いとうかなこ,ZIZZ"
    },
    {
        "id": 8507,
        "name": "いとうかなこ,Zwei"
    },
    {
        "id": 8614,
        "name": "彩音,いとうかなこ"
    },
    {
        "id": 8769,
        "name": "いとうかなこ,ワタナベカズヒロ"
    }
]

GET /Api/v1/singers/{id}

Response例


$ curl https://2ndrelaypumpstation.net/Api/v1/singers/3363


{
    "id": 3363,
    "name": "いとうかなこ",
    "songs": [
        {
            "id": 13249,
            "title": "青い記憶",
            "anisoninfo_song_id": 25127,
            "song_role": {
                "id": 1,
                "code": "OP",
                "name": "オープニングテーマ"
            },
            "program": {
                "id": 13794,
                "title": "Hello, world",
                "kana_title": "ハローワールド",
                "other_title_01": "",
                "other_title_02": "",
                "anisoninfo_program_id": 4773,
                "broadcast_start_on": "2002-09-27",
                "program_type": {
                    "id": 3,
                    "code": "GM",
                    "name": "ゲーム"
                }
            }
        },
        {
            "id": 13251,
            "title": "煌星",
            "anisoninfo_song_id": 25129,
            "song_role": {
                "id": 2,
                "code": "ED",
                "name": "エンディングテーマ"
            },
            "program": {
                "id": 13794,
                "title": "Hello, world",
                "kana_title": "ハローワールド",
                "other_title_01": "",
                "other_title_02": "",
                "anisoninfo_program_id": 4773,
                "broadcast_start_on": "2002-09-27",
                "program_type": {
                    "id": 3,
                    "code": "GM",
                    "name": "ゲーム"
                }
            }
        }
        //省略
    ]
}



各データ構造

program

概要
  • 番組データ
  • ゲームや劇場版等の情報もある
Model
Property Value description Sample
id Number program_id 7590
title string 番組タイトル "Steins;Gate"
kana_title string 番組タイトルの読み仮名 "シュタインズゲート"
other_title_01 string 番組タイトル予備枠01 ""
other_title_01 string 番組タイトル予備枠02 ""
anisoninfo_program_id Number AnisonGeneration上の管理番号 13401
broadcast_start_on Date 放送開始年月日(yyyy-MM-dd)ゲームの場合は発売日、劇場版の場合は公開日 "2011-04-06"
program_type program_type 番組種別 {"id":2,"code":"TV","name":"テレビアニメーション"}
game_genre game_genre ゲームのジャンル種別 {"id":1,"name":""}

program_type

概要
  • 番組種別(TVアニメーション、ゲーム、劇場版など)
Model
Property Value description Sample
id Number program_type_id 2
code string 番組種別コード TV
name string 番組種別名称 テレビアニメーション

game_genre

概要
  • ゲームのジャンル種別(RPG、アクション、アドベンチャーなど)
  • 番組種別がゲームでない場合は該当なしのデータが入る
Model
Property Value description Sample
id Number game_genre_id 6
name string ゲームジャンル名称 アドベンチャー

song

概要
  • 楽曲データ
Model
Property Value description Sample
id Number song_id 23825
title string 楽曲タイトル "Hacking to the Gate"
anisoninfo_song_id Number AnisonGeneration上の管理番号 67986
singer singer 歌手データ {"id":3363,"name":"いとうかなこ"}
program program タイアップ番組のデータ レスポンス例を参照のこと
song_role song_role 楽曲の役割(OP、EDなど) {"id":1,"code":"OP","name":"オープニングテーマ"}

singer

概要
  • 歌手データ
Model
Property Value description Sample
id Number song_id 3363
name string 歌手名 いとうかなこ

song_role

概要
  • 楽曲の役割種別データ
Model
Property Value description Sample
id Number song_id 1
code string 楽曲の役割種別コード OP
name string 楽曲の役割種別名称 オープニングテーマ

今後の更新予定

  • 楽曲データを応答するAPI (2018-05-20更新)
  • 歌手名による検索 (2018-05-21更新)

Apiの仕様作成にあたり参考にさせて頂いた情報

放映中のアニメ作品の情報を提供するAnime RESTful API サーバー作りました

バグ等ありましたらご報告いただけると幸いです。