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
}