GET /v1/users

Annictに登録されているユーザ情報を取得することができます。

フィールド

名前	概要
id	ユーザID
username	URLなどで使用されているユーザ名
name	ユーザの名前
description	プロフィール
url	ユーザのURL
avatar_url	アバター画像
background_image_url	背景画像
records_count	記録数
followings_count	ユーザがフォローしている人の数
followers_count	ユーザをフォローしている人の数
wanna_watch_count	ステータスを「見たい」にしている作品の数
watching_count	ステータスを「見てる」にしている作品の数
watched_count	ステータスを「見た」にしている作品の数
on_hold_count	ステータスを「中断」にしている作品の数
stop_watching_count	ステータスを「中止」にしている作品の数
created_at	ユーザ登録した日時

パラメータ

名前	概要	使用例
fields	レスポンスボディに含まれるデータのフィールドを絞り込みます。	fields=id,username
filter_ids	ユーザをIDで絞り込みます。	filter_ids=1,2,3
filter_usernames	ユーザをユーザ名で絞り込みます。	filter_usernames=shimbaco,datekoichi
page	ページ数を指定します。	page=2
per_page	1ページに何件取得するかを指定します。デフォルトは 25 件で、50 件まで指定できます。	per_page=30
sort_id	ユーザをIDで並び替えます。asc または desc が指定できます。	sort_id=desc

リクエスト例

$ curl -X GET https://api.annict.com/v1/users?access_token=(access_token)&filter_usernames=shimbaco

{
  "users": [
    {
      "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": 2369,
      "followings_count": 258,
      "followers_count": 205,
      "wanna_watch_count": 237,
      "watching_count": 103,
      "watched_count": 335,
      "on_hold_count": 45,
      "stop_watching_count": 244,
      "created_at": "2014-03-02T15:38:40.000Z"
    }
  ],
  "total_count": 1,
  "next_page": null,
  "prev_page": null
}