x/
check-follow

1つのXアカウントが最大100件の他のアカウントをフォローしているか、また相手がフォローバックしているかを確認し、ユーザー名の各ペアについて is_following、is_followed_by、is_mutual を返します。

Twitter Follow Checker API

双方向のフォローを確認
1タスク最大100ペア
相互フォローのフラグ
結果1件あたり0.7クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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行を読み取ります。

  1. {"username": "elonmusk", "usernames": ["SpaceX", "NASA"]} を /v1/x/check-follow に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. 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 を保存し、後日同じチェックを再実行してください。実行結果を比べると、新しいフォローとフォロー解除がわかります。

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への接続方法、登録日、ユーザー名の変更回数を確認します。

他のプラットフォームを見る

Xのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Twitter Follow Checker API — よくある質問

Twitter Follow Checker APIは、ユーザー名だけを使って、1つのXアカウントと最大100件の他のアカウントとのフォロー関係を確認するためのプログラムインターフェースです。各ペアについて、1つ目のアカウントが2つ目をフォローしているか、フォローバックされているか、相互フォローかを返します。

1つ目のアカウントを username に、2つ目を usernames に入れます。is_following で1つ目が2つ目をフォローしているかがわかり、同じ行の is_followed_by で逆方向がわかります。

自分のハンドルを username に、相手のハンドルを usernames に入れます。is_followed_by が true なら相手は自分をフォローしており、1つのタスクで最大100アカウントを確認できます。

is_mutual を確認してください。互いにフォローしている場合にだけ true になります。

username の1アカウントに対して、usernames に最大100件を指定でき、ペアごとに1行が返ります。それより長いリストは複数のタスクに分けてください。

確認はユーザー名をもとに公開アカウントを対象に行われます。非公開アカウントはXでフォローの一覧を非表示にしているため、それらを含むペアは確認できません。

このエンドポイントではできません。返すのは送信したペアだけです。完全な一覧には X Following List API または X Followers List API を使用してください。