Annict Docs
Search…
⌃K

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