Annict Docs
Search
K
Comment on page

GET /v1/reviews

作品へのレビューを取得することができます。

フィールド

名前
概要
id
レビューID
title
[非推奨] レビュータイトル
body
感想
rating_animation_state
レビューしたときに付けられたレーティング (作画)。bad average good great の4種類のうち1つが入っています。
rating_music_state
レビューしたときに付けられたレーティング (音楽)。bad average good great の4種類のうち1つが入っています。
rating_story_state
レビューしたときに付けられたレーティング (ストーリー)。bad average good great の4種類のうち1つが入っています。
rating_character_state
レビューしたときに付けられたレーティング (キャラクター)。bad average good great の4種類のうち1つが入っています。
rating_overall_state
レビューしたときに付けられたレーティング (全体)。bad average good great の4種類のうち1つが入っています。
likes_count
Likeされた数
impressions_count
PV数
created_at
レビューが投稿された日時
modified_at
レビューが編集された日時
user
このレビューを投稿した利用者の情報
work
このレビューが紐づく作品情報。取得できるフィールドは Works と同じです。

パラメータ

名前
概要
使用例
fields
レスポンスボディに含まれるデータのフィールドを絞り込みます。
fields=id,title
filter_ids
レビューをレビューIDで絞り込みます。
filter_ids=1,2,3
filter_work_id
レビューを作品IDで絞り込みます。
filter_work_id=1111
filter_has_review_body
レビューを感想のあるなしで絞り込みます。感想付きのレビューのみに絞り込むときは true を、感想の無い記録のみに絞り込むときは false を指定します。
filter_has_review_body=true
page
ページ数を指定します。
page=2
per_page
1ページに何件取得するかを指定します。デフォルトは 25 件で、50 件まで指定できます。
per_page=30
sort_id
レビューをレビューIDで並び替えます。asc または desc が指定できます。
sort_id=desc
sort_likes_count
レビューをLikeされた数で並び替えます。asc または desc が指定できます。
sort_likes_count=desc

リクエスト例

$ curl -X GET https://api.annict.com/v1/reviews?filter_work_id=3994&access_token=(access_token)
{
"reviews": [
{
"id": 594,
"title": "あぁ^~心がぴょんぴょんするんじゃぁ^~",
"body": "みんなかわいい",
"rating_animation_state": "good",
"rating_music_state": "good",
"rating_story_state": "good",
"rating_character_state": "great",
"rating_overall_state": "great",
"likes_count": 0,
"impressions_count": 1,
"modified_at": null,
"created_at": "2017-06-24T18:51:35.075Z",
"user": {
"id": 2,
"username": "shimbaco",
"name": "Koji Shimba",
"description": "アニメ好きが高じてこのサービスを作りました。聖地巡礼を年に数回しています。",
"url": "http://shimba.co",
"avatar_url": "https://api-assets.annict.com/paperclip/profiles/1/tombo_avatars/master/d8af7adc8122c96ba7639218fd8b5ede332d42f2.jpg?1431357292",
"background_image_url": "https://api-assets.annict.com/paperclip/profiles/1/tombo_background_images/master/ee15d577fb2f2d61bdaf700cfab894b286a5762d.jpg?1486753229",
"records_count": 1906,
"created_at": "2014-03-02T15:38:40.000Z"
},
"work": {
"id": 3994,
"title": "ご注文はうさぎですか?",
"title_kana": "ごちゅうもんはうさぎですか",
"media": "tv",
"media_text": "TV",
"released_on": "2014-04-10",
"released_on_about": "",
"official_site_url": "http://www.gochiusa.com/",
"wikipedia_url": "http://ja.wikipedia.org/wiki/%E3%81%94%E6%B3%A8%E6%96%87%E3%81%AF%E3%81%86%E3%81%95%E3%81%8E%E3%81%A7%E3%81%99%E3%81%8B%3F#.E3.83.86.E3.83.AC.E3.83.93.E3.82.A2.E3.83.8B.E3.83.A1",
"twitter_username": "usagi_anime",
"twitter_hashtag": "gochiusa",
"images": {
"recommended_url": "https://twitter.com/usagi_anime/profile_image?size=bigger",
"facebook": {
"og_image_url": ""
},
"twitter": {
"mini_avatar_url": "https://twitter.com/usagi_anime/profile_image?size=mini",
"normal_avatar_url": "https://twitter.com/usagi_anime/profile_image?size=normal",
"bigger_avatar_url": "https://twitter.com/usagi_anime/profile_image?size=bigger",
"original_avatar_url": "https://twitter.com/usagi_anime/profile_image?size=original",
"image_url": ""
}
},
"episodes_count": 12,
"watchers_count": 1463,
"season_name": "2014-spring",
"season_name_text": "2014年春"
}
},
...
],
"total_count": 6,
"next_page": null,
"prev_page": null
}