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