Annict Docs
Search
K
Comment on page

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
},
...