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の作品に関するハッシュタグ
episodes_count エピソード数
watchers_count 見てる / 見たい / 見た人の数

パラメータ

名前 概要 使用例
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",
      "episodes_count": 24,
      "watchers_count": 1254
    },
  ]
...