Annict Docs
Search…
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が高確率で格納されるプロパティになります

パラメータ

名前
概要
使用例
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

リクエスト例

1
$ curl -X GET https://api.annict.com/v1/works?access_token=(access_token)
Copied!
1
{
2
"works": [
3
{
4
"id": 4168,
5
"title": "SHIROBAKO",
6
"title_kana": "しろばこ",
7
"media": "tv",
8
"media_text": "TV",
9
"season_name": "2014-autumn",
10
"season_name_text": "2014年秋",
11
"released_on": "2014-10-09",
12
"released_on_about": "",
13
"official_site_url": "http://shirobako-anime.com",
14
"wikipedia_url": "http://ja.wikipedia.org/wiki/SHIROBAKO",
15
"twitter_username": "shirobako_anime",
16
"twitter_hashtag": "musani",
17
"syobocal_tid": "3524",
18
"mal_anime_id": "25835",
19
"images": {
20
"recommended_url": "http://shirobako-anime.com/images/ogp.jpg",
21
"facebook": {
22
"og_image_url": "http://shirobako-anime.com/images/ogp.jpg"
23
},
24
"twitter": {
25
"mini_avatar_url": "https://twitter.com/shirobako_anime/profile_image?size=mini",
26
"normal_avatar_url": "https://twitter.com/shirobako_anime/profile_image?size=normal",
27
"bigger_avatar_url": "https://twitter.com/shirobako_anime/profile_image?size=bigger",
28
"original_avatar_url": "https://twitter.com/shirobako_anime/profile_image?size=original",
29
"image_url": ""
30
}
31
},
32
"episodes_count": 24,
33
"watchers_count": 1254
34
},
35
]
36
...
Copied!