X Verified Followers
Xの認証済みフォロワーとは、アカウントのフォロワーのうち認証バッジを持つ層のことで、プロフィールの「認証済みフォロワー」タブに一覧表示され、各フォロワーにはハンドル、表示名、アイコン画像、Xの利用開始日が付いています。この一覧はクリエイター、ブランド、有料ユーザーで占められているため、どの定着したアカウントがすでにそのプロフィールに注目しているかがわかり、アウトリーチ、競合調査、オーディエンスの質の確認に使えるコンパクトなサンプルになります。
X Verified Followers API の主な機能
- 「認証済みフォロワー」タブのフォロワー行は、プロフィールの「認証済みフォロワー」タブにXが表示するのと同じ一覧から取得されるため、返るフォロワーはすべて is_verified が true です。
- 各行に両方のアカウントを記載actor は照会したアカウント、related_actor は認証済みフォロワーで、relationship は follower になります。複数のユーザー名の行が1つの結果セットに混ざっても区別できます。
- フォロワーの身元とプロフィールリンクrelated_actor には各フォロワーの id、username、表示名、プロフィールの url、avatar_url が入り、アカウントを開く、確認する、エクスポートするのに十分な情報がそろいます。
- 各フォロワーがXを使い始めた日各行の published_at は認証済みフォロワーのアカウントの利用開始日で、古くからあるアカウントと最近作られたアカウントを見分けられます。
- ユーザー名ごとに20〜2,000件results_limit はユーザー名ごとに20単位で適用され、20件の手早いサンプルから最大2,000件の認証済みフォロワーまで取得できます。
X Verified Followers API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
usernames | 必須 | 認証済みフォロワーを収集するXのユーザー名です。アカウントごとに個別に収集されます。 |
results_limit | 任意 | ユーザー名ごとに返す認証済みフォロワーの件数です。20〜2,000の範囲で20の倍数を指定し、デフォルトは100です。 |
X Verified Followers API の使い方
ユーザー名を送信し、それぞれについて収集する認証済みフォロワーの件数を決めてから、行をページごとに読み取ります。
- {"usernames": ["NASA"], "results_limit": 100} を /v1/x/verified-followers に 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/verified-followers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["NASA"],"results_limit":100}'
# related_actor is the verified follower; actor is the account you asked about.X Verified Followers API の主なユースケース
- 競合の認証済みオーディエンスからアウトリーチリストを作成: 競合の認証済みフォロワーを収集し、related_actor.username と url をエクスポートして、すでに自社の分野をフォローしているクリエイター、ブランド、サブスクライバーにアプローチします。
- 競合だけをフォローしている認証済みアカウントの発見: 自社アカウントと競合アカウントの認証済みフォロワーを1つのタスクで収集し、競合の一覧にだけ現れる related_actor.id を残します。
- 複数プロフィールの認証済みオーディエンスの比較: 複数のユーザー名をまとめて送信し、行数と共通する related_actor.id を比べて、同じ認証済みアカウントを引きつけているプロフィールを見つけます。
- 新しく作られた認証済みフォロワーの急増を察知: プロフィールの認証済みフォロワーを published_at で並べ替え、チェックマーク付きのオーディエンスが古くからのアカウント中心か、最近Xに参加したアカウント中心かを確認します。
X Verified Followers API 活用のヒント
- まず results_limit を20にして、そのプロフィールに収集する価値のある認証済みオーディエンスがあるかを確かめてから引き上げてください。返されたフォロワー1件につき0.7クレジットです。
- あるユーザー名でちょうど results_limit と同じ件数の行が返った場合は、認証済みフォロワーがさらにいる可能性があるため、上限を2,000に向けて引き上げると全体像をつかめます。
- フォロワーは related_actor.id をキーにし、collected_at で実行結果を比べると、前回のチェック以降に新しく加わった認証済みアカウントがわかります。
- 照会したアカウントは actor.username から読み取ってください。actor のその他のフィールドは空の場合があり、フォロワーの詳細は related_actor に入っています。
関連API
X Verified Followers 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 Account Location API — アカウントの拠点となる国、Xへの接続方法、登録日、ユーザー名の変更回数を確認します。
- Twitter Follow Checker API — あるアカウントがほかのアカウントをフォローしているか、相手がフォローバックしているかを確認します。
- 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 API
- X Community Posts API
- X Thread Context 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