指定したユーザをフォローしている人の一覧を取得するエンドポイントです。
リクエストの送り方やページネーションについてはREST API V1の概要をご参照ください。
GET /v1/followers
Annictに登録されているユーザのフォロワー (フォローされている人) 情報を取得することができます。
フィールド
REST API V1のユーザのフィールドと同じです。
パラメータ
| 名前 | 概要 | 使用例 |
|---|---|---|
| fields | レスポンスボディに含まれるデータのフィールドを絞り込みます。 | fields=id,username |
| filter_user_id | ユーザIDで絞り込みます。 | filter_user_id=2 |
| filter_username | ユーザ名で絞り込みます。 | filter_username=shimbaco |
| 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/followers?access_token=(access_token)&filter_username=shimbaco&per_page=2
{
"users": [
{
"id": 7,
"username": "Yukino",
"name": "雪ノ下雪乃",
"description": "総武高校2年J組に所属している女子生徒で奉仕部の部長です。",
"url": null,
"avatar_url": "https://api-assets.annict.com/480862747fc5f7152a031e24f0c0374dc71c539a.jpg",
"background_image_url": "https://api-assets.annict.com/7e258e0189e9ee38f4dc0c57b2c9f6b39dd2cd95.jpg",
"records_count": 260,
"followings_count": 31,
"followers_count": 45,
"wanna_watch_count": 20,
"watching_count": 9,
"watched_count": 88,
"on_hold_count": 2,
"stop_watching_count": 5,
"created_at": "2014-03-10T04:11:54.000Z"
}
],
"total_count": 191,
"next_page": 2,
"prev_page": null
}