Skip to main content

ユーザ

GET /v1/users​

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

フィールド​

名前概要
idユーザID
usernameURLなどで使用されているユーザ名
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_page1ページに何件取得するかを指定します。デフォルトは 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
}

GET /v1/me​

自分のプロフィール情報を取得することができます。

フィールド​

名前概要
idユーザID
usernameURLなどで使用されているユーザ名
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ユーザ登録した日時
emailユーザのメールアドレス
notifications_count通知数

パラメータ​

名前概要使用例
fieldsレスポンスボディに含まれるデータのフィールドを絞り込みます。fields=id,username

リクエスト例​

$ curl -X GET https://api.annict.com/v1/me?access_token=(access_token)
{
  "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",
  "email": "me@shimba.co",
  "notifications_count": 0
}