x/
verified-followers

ユーザー名から、Xプロフィールをフォローしている認証済みアカウントを収集します。各フォロワーのハンドル、名前、プロフィールリンク、アイコン画像、利用開始日を、1アカウントにつき最大2,000件返します。

X Verified Followers API

「認証済みフォロワー」タブ
1アカウント最大2,000件
フォロワーの利用開始日
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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 の使い方

ユーザー名を送信し、それぞれについて収集する認証済みフォロワーの件数を決めてから、行をページごとに読み取ります。

  1. {"usernames": ["NASA"], "results_limit": 100} を /v1/x/verified-followers に 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/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 に入っています。

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 — あるアカウントがほかのアカウントをフォローしているか、相手がフォローバックしているかを確認します。

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

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

X Verified Followers API — よくある質問

X Verified Followers APIは、ユーザー名からXアカウントのチェックマーク付きフォロワーを1アカウントにつき最大2,000件収集するためのプログラムインターフェースです。各行は照会したアカウントと1人の認証済みフォロワーを結び付け、そのフォロワーの id、ユーザー名、名前、プロフィールURL、アイコン画像、利用開始日を含みます。

Xでは、プロフィールのフォロワー画面にある「認証済みフォロワー」タブに表示されます。ここでそのユーザー名を送信すると、同じ一覧を並べ替え、絞り込み、エクスポートできる行として受け取れます。

Xで認証バッジ(チェックマーク)が付いているフォロワーで、Xが「認証済みフォロワー」タブに表示するアカウントです。返されるフォロワーはすべて related_actor.is_verified が true です。

はい、そのユーザー名で返された行数を数えれば確認できます。最も広く見るには results_limit を2,000にしてください。認証済みフォロワーがそれより多いアカウントは2,000行を返すため、その数は最低値として読んでください。

いいえ。行に含まれるのはフォロワーの id、ユーザー名、名前、プロフィールURL、アイコン画像、認証フラグ、利用開始日です。フォロワー数やプロフィール文が必要な場合は、それらのユーザー名を Twitter Profile Scraper API に渡してください。

いいえ。ここでの published_at は認証済みフォロワーがXの利用を始めた日で、フォローした日時そのものは結果に含まれません。