GET /v1/episodes

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

フィールド

名前

概要

id

エピソードのID

number

エピソードの話数

number_text

エピソードの話数 (表記用)

sort_number

ソート用の番号。話数でソートすると正しく並べられないケースがあるため、このフィールドが存在します。

title

サブタイトル

records_count

記録数

record_comments_count

感想付きの記録数

work

このエピソードが紐づく作品情報。取得できるフィールドは Works と同じです。

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

Last updated