クイックスタート

フォロワーリストとフォロー中リストを取得し、フォロー関係を管理する

このガイドでは、フォロワーリストおよびフォローしているアカウントのリストの取得と、フォローの管理方法について説明します。

前提条件

始める前に、次のものが必要です。

• 承認済みの App を持つ開発者アカウント
• App のベアラートークン (ルックアップ用)
• ユーザーアクセストークン (フォロー管理用)

---

​

ユーザーのフォロワーを取得する

特定のユーザーをフォローしているユーザーの一覧を取得します。

cURL

shellscript

curl "https://api.x.com/2/users/2244994945/followers?\
user.fields=username,verified,public_metrics&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

レスポンス

{
  "data": [
    {
      "id": "1234567890",
      "name": "Developer",
      "username": "dev_user",
      "verified": false,
      "public_metrics": {
        "followers_count": 500,
        "following_count": 200,
        "tweet_count": 1500
      }
    }
  ],
  "meta": {
    "result_count": 1,
    "next_token": "abc123"
  }
}

---

​

特定のユーザーがフォローしているユーザーを取得する

特定のユーザーがフォローしているユーザーのリストを取得します。

cURL

shellscript

curl "https://api.x.com/2/users/2244994945/following?\
user.fields=username,verified&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

ユーザーをフォローする

認証済みユーザーとして別のユーザーをフォローします。

cURL

shellscript

curl -X POST "https://api.x.com/2/users/123456789/following" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_user_id": "2244994945"}'

​

レスポンス

{
  "data": {
    "following": true,
    "pending_follow": false
  }
}

対象アカウントが非公開アカウントの場合、フォローリクエストが承認されるまで pending_follow は true のままになります。

---

​

ユーザーのフォローを解除する

認証済みユーザーに代わって、ユーザーのフォローを解除します。

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/123456789/following/2244994945" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​

レスポンス

{
  "data": {
    "following": false
  }
}

---

​

共通パラメーター

Parameter	Description
max_results	1 ページあたりの結果数 (1～1000、デフォルト 100)
pagination_token	次のページ用のトークン
user.fields	追加のユーザーフィールド
expansions	レスポンスに含める関連オブジェクト

---

​

次のステップ

ユーザー検索

ユーザープロフィールを取得する

ブロック

ユーザーをブロック／ブロック解除する

ミュート

ユーザーをミュート／ミュート解除する

APIリファレンス

エンドポイントの詳細リファレンス