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
}
Last modified 2yr ago