Skip to main content

作品

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_urlWikipediaのURL
twitter_username公式Twitterアカウントのusername
twitter_hashtagTwitterの作品に関するハッシュタグ
syobocal_tidしょぼいカレンダーのタイトルID
mal_anime_idMyAnimeListの作品ID
images.facebook.og_image_urlofficial_site_url のページで取得できる og:image のURL
images.twitter.(mini/normal/bigger/original)_avatar_urlTwitterアカウントのアバター画像。mini, normal, bigger, original の4種類のサイズがあります
images.twitter.image_urlofficial_site_url のページで取得できる twitter:image のURL
images.recommended_urlfacebook.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_page1ページに何件取得するかを指定します。デフォルトは 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
    },
  ]
...

GET /v1/me/works​

自分がステータスを設定している作品の情報を取得することができます。

フィールド​

GET /v1/works のフィールドに加えて、下記のフィールドが存在します。

名前概要
status.kindステータスの種類

パラメータ​

名前概要使用例
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
filter_status作品をステータスで絞り込みます。wanna_watch, watching, watched, on_hold, stop_watching が指定できます。filter_status=watching
pageページ数を指定します。page=2
per_page1ページに何件取得するかを指定します。デフォルトは 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/me/works?access_token=(access_token)
{
  "works": [
    {
      "id": 4681,
      "title": "ふらいんぐうぃっち",
      "title_kana": "ふらいんぐうぃっち",
      "media": "tv",
      "media_text": "TV",
      "season_name": "2016-spring",
      "season_name_text": "2016年春",
      "released_on": "",
      "released_on_about": "",
      "official_site_url": "http://www.flyingwitch.jp/",
      "wikipedia_url": "https://ja.wikipedia.org/wiki/%E3%81%B5%E3%82%89%E3%81%84%E3%82%93%E3%81%90%E3%81%86%E3%81%83%E3%81%A3%E3%81%A1",
      "twitter_username": "flying_tv",
      "twitter_hashtag": "flyingwitch",
      "episodes_count": 5,
      "watchers_count": 695,
      "status": {
        "kind": "watching"
      }
    }
  ],
...