Skip to main content

エピソード

GET /v1/episodes​

Annictに登録されているエピソード情報を取得することができます。

フィールド​

名前概要
idエピソードのID
numberエピソードの話数
number_textエピソードの話数 (表記用)
sort_numberソート用の番号。話数でソートすると正しく並べられないケースがあるため、このフィールドが存在します。
titleサブタイトル
records_count記録数
record_comments_count感想付きの記録数
workこのエピソードが紐づく作品情報。取得できるフィールドは 作品 と同じです。
prev_episodeこのエピソードの前のエピソード情報。取得できるフィールドは同じです。
next_episodeこのエピソードの次のエピソード情報。取得できるフィールドは同じです。

パラメータ​

名前概要使用例
fieldsレスポンスボディに含まれるデータのフィールドを絞り込みます。fields=id,title
filter_idsエピソードをエピソードIDで絞り込みます。filter_ids=1,2,3
filter_work_idエピソードを作品IDで絞り込みます。filter_work_id=1111
pageページ数を指定します。page=2
per_page1ページに何件取得するかを指定します。デフォルトは 25 件で、50 件まで指定できます。per_page=30
sort_idエピソードをエピソードIDで並び替えます。asc または desc が指定できます。sort_id=desc
sort_sort_numberエピソードをソート用の番号で並び替えます。asc または desc が指定できます。sort_sort_number=desc

リクエスト例​

$ curl -X GET https://api.annict.com/v1/episodes?access_token=(access_token)
{
  "episodes": [
    {
      "id": 45,
      "number": null,
      "number_text": "第2話",
      "sort_number": 2,
      "title": "殺戮の夢幻迷宮",
      "records_count": 0,
      "record_comments_count": 0,
      "work": {
        "id": 3831,
        "title": "NEWドリームハンター麗夢",
        "title_kana": "",
        "media": "ova",
        "media_text": "OVA",
        "season_name": "1990-autumn",
        "season_name_text": "1990年秋",
        "released_on": "1990-12-16",
        "released_on_about": "",
        "official_site_url": "",
        "wikipedia_url": "",
        "twitter_username": "",
        "twitter_hashtag": "",
        "episodes_count": 2,
        "watchers_count": 10
      },
      "prev_episode": {
        "id": 44,
        "number": null,
        "number_text": "第1話",
        "sort_number": 1,
        "title": " 夢の騎士達",
        "records_count": 0,
        "record_comments_count": 0
      },
      "next_episode": null
    },
...