> For the complete documentation index, see [llms.txt](https://docs.annict.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.annict.com/docs/ja/api/v1/episodes.md).

# GET /v1/episodes

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

## フィールド

| 名前                      | 概要                                                                   |
| ----------------------- | -------------------------------------------------------------------- |
| id                      | エピソードのID                                                             |
| number                  | エピソードの話数                                                             |
| number\_text            | エピソードの話数 (表記用)                                                       |
| sort\_number            | ソート用の番号。話数でソートすると正しく並べられないケースがあるため、このフィールドが存在します。                    |
| title                   | サブタイトル                                                               |
| records\_count          | 記録数                                                                  |
| record\_comments\_count | 感想付きの記録数                                                             |
| work                    | このエピソードが紐づく作品情報。取得できるフィールドは [Works](/docs/ja/api/v1/works.md) と同じです。 |
| 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\_page          | 1ページに何件取得するかを指定します。デフォルトは `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)
```

```javascript
{
  "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
    },
...
```