Twitter Follow Checker
X(旧Twitter)のフォローはあるアカウントから別のアカウントへの一方向のつながりなので、任意の2つのアカウントは、フォロー関係なし、前者から後者へのフォロー、後者から前者へのフォロー、相互フォローという4つの状態のいずれかにあります。ペアがどの状態にあるかがわかれば、プレゼント企画の応募者がブランドをフォローしているか、パートナーがフォローバックしたか、クリエイターのグループがどれだけ密につながっているかといった日常的な疑問に答えられます。
Twitter Follow Checker API の主な機能
- 1つのアカウントを最大100件と照合確認するアカウントを username に、最大100件のアカウントを usernames に入れると、各組み合わせが source_username と target_username を含む1行として返ります。
- 双方向と相互フォローの結果を1行にis_following は username が相手をフォローしているか、is_followed_by は相手がフォローバックしているかを示し、両方が成り立つと is_mutual が true になります。
- ペアのキーとプロフィールリンクid は source_username:target_username の形式で、url は相手のプロフィールを指すため、行を自分のリストにきれいに結合でき、ワンクリックで開けます。
Twitter Follow Checker API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
username | 必須 | 確認するXアカウントで、usernames 内のすべてのアカウントと比較されます。 |
usernames | 必須 | username と比較するXのユーザー名で、最大100件です。各ユーザー名につき、そのペアの行が1つ返ります。 |
Twitter Follow Checker API の使い方
1つのアカウントと比較対象のアカウントを送信し、ペアごとに1行を読み取ります。
- {"username": "elonmusk", "usernames": ["SpaceX", "NASA"]} を /v1/x/check-follow に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items から各ペアを読み取り、has_more が true の間は results.next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/x/check-follow" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"elonmusk","usernames":["SpaceX","NASA"]}'
# is_following: elonmusk follows the target; is_followed_by: the target follows elonmusk back.Twitter Follow Checker API の主なユースケース
- プレゼント企画の応募者のフォロー条件を確認: ブランドのアカウントを username に、最大100人の応募者を usernames に入れ、is_followed_by が true の応募者を残します。
- フォローバック待ちのパートナーを見つける: 自分のアカウントを、フォローしているクリエイターやブランドと照合し、is_following が true で is_followed_by が false のペアを一覧にします。
- クリエイターグループ内のつながりを可視化: 各メンバーを順に username にしてグループの他のメンバーと照合し、is_mutual を使って誰と誰がつながっているかを図にします。
- 重要アカウントがフォローする競合ブランドの監視: 経営者やジャーナリストのアカウントを競合のリストと照合し、後日同じチェックを繰り返して、is_following が変わるタイミングを確認します。
Twitter Follow Checker API 活用のヒント
- 100件を超えるリストは、重複を除いてから100件ずつのバッチに分け、結果を id で統合してください。
- 結果に行が欠けている対象は「未確認」として記録し、false と報告されたペアとは分けて管理してください。行が生成されるのは見つかったアカウントだけです。
- 各ペアに collected_at を保存し、後日同じチェックを再実行してください。実行結果を比べると、新しいフォローとフォロー解除がわかります。
関連API
Twitter Follow Checker API 以外に別の種類の公開Xデータが必要な場合は、これらのAPIをご利用ください。
- Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
- X Followers List API — 1つ以上のXユーザー名について、公開フォロワーのアカウント情報と表示中のプロフィール指標を取得します。
- X Following List API — 公開Xアカウントがフォローしているプロフィールを、アカウント情報、プロフィール文、アカウントシグナル、表示中のカウント、元のユーザー名とともに取得します。
- X Post Retweeters API — 既知のXまたはTwitterのステータスURLをリポストしたアカウントについて、正規化された公開プロフィールをタスク単位で重複なく取得します。
- X Community API — コミュニティのリンクから、説明、メンバー数、ルール、参加ポリシーを取得します。
- X Account Location API — アカウントの拠点となる国、Xへの接続方法、登録日、ユーザー名の変更回数を確認します。
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Video Transcript API