GET /v1/works
Annictに登録されている作品情報を取得することがで きます。
名前 | 概要 |
id | 作品のID |
title | 作品のタイトル |
title_kana | 作品タイトルの読み仮名 |
media | リリース媒体 tv, ova, movie, web, other |
media_text | リリース媒体 (表記用) TV, OVA, 映画, Web, その他 |
season_name | リリース時期 |
season_name_text | リリース時期 (表記用) |
released_on | リリース日 |
released_on_about | 未確定な大体のリリース日 |
official_site_url | 公式サイトのURL |
wikipedia_url | WikipediaのURL |
twitter_username | 公式Twitterアカウントのusername |
twitter_hashtag | Twitterの作品に関するハッシュタグ |
syobocal_tid | しょぼいカレンダーのタイトルID |
mal_anime_id | MyAnimeListの作品ID |
images.facebook.og_image_url | official_site_url のページで取得できる og:image のURL |
images.twitter.(mini/normal/bigger/original)_avatar_url | Twitterアカウントのアバター画像。 mini, normal, bigger, original の4種類のサイズがあります |
images.twitter.image_url | official_site_url のページで取得できる twitter:image のURL |
images.recommended_url | facebook.og_image_url, twitter.bigger_avatar_url, twitter.image_url のうち、解像度が一番大きい画像のURL。扱いやすい画像のURLが高確率で格納されるプロパティになります |
episodes_count | エピソード数 |
watchers_count | 見てる / 見たい / 見た人の数 |
reviews_count | レビュー数 |
no_episodes | エピソードが存在しない作品かどうか。例えば映画はエピソードが存在しない作品なので、 true になります |
名前 | 概要 | 使用例 |
fields | レスポンスボディに含まれるデータのフィールドを絞り込みます。 | fields=id,title |
filter_ids | 作品を作品IDで絞り込みます。 | filter_ids=1,2,3 |
filter_season | 作品をリリース時期で絞り込みます。 2016-all としたときは、2016年にリリースされる作品全てを取得することができます。 | filter_season=2016-spring |
filter_title | 作品をタイトルで絞り込みます。 | filter_title=shirobako |
page | ページ数を指定します。 | page=2 |
per_page | 1ページに何件取得するかを指定します。デフォルトは 25 件で、50 件まで指定できます。 | per_page=30 |
sort_id | 作品を作品IDで並び替えます。 asc または desc が指定できます。 | sort_id=desc |
sort_season | 作品をリリース時期で並び替えます。 asc または desc が指定できます。 | sort_season=desc |
sort_watchers_count | 作品をWatchersの数で並び替えます。 asc または desc が指定できます。 | sort_watchers_count=desc |
$ curl -X GET https://api.annict.com/v1/works?access_token=(access_token)
{
"works": [
{
"id": 4168,
"title": "SHIROBAKO",
"title_kana": "しろばこ",
"media": "tv",
"media_text": "TV",
"season_name": "2014-autumn",
"season_name_text": "2014年秋",
"released_on": "2014-10-09",
"released_on_about": "",
"official_site_url": "http://shirobako-anime.com",
"wikipedia_url": "http://ja.wikipedia.org/wiki/SHIROBAKO",
"twitter_username": "shirobako_anime",
"twitter_hashtag": "musani",
"syobocal_tid": "3524",
"mal_anime_id": "25835",
"images": {
"recommended_url": "http://shirobako-anime.com/images/ogp.jpg",
"facebook": {
"og_image_url": "http://shirobako-anime.com/images/ogp.jpg"
},
"twitter": {
"mini_avatar_url": "https://twitter.com/shirobako_anime/profile_image?size=mini",
"normal_avatar_url": "https://twitter.com/shirobako_anime/profile_image?size=normal",
"bigger_avatar_url": "https://twitter.com/shirobako_anime/profile_image?size=bigger",
"original_avatar_url": "https://twitter.com/shirobako_anime/profile_image?size=original",
"image_url": ""
}
},
"episodes_count": 24,
"watchers_count": 1254
},
]
...
Last modified 2yr ago