x/
community-members

公開Xコミュニティのリンクからメンバーをエクスポートします。各メンバーのプロフィール文、所在地、ウェブサイト、認証フラグ、フォロワー数などを、1コミュニティにつき最大2,000人分返します。

X Community Members API

コミュニティのリンクを入力
メンバーごとに1件のプロフィール
1コミュニティ最大2,000人
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

X Community Members

Xコミュニティのメンバーは、トピック別のコミュニティに自ら参加したアカウントで、それぞれにプロフィール文、所在地、ウェブサイト、認証状態、アカウント作成日、フォロワー数・フォロー数・ポスト数を含む公開プロフィールがあります。参加は1つのテーマをめぐる意図的な行動なので、これらのプロフィールは自ら集まったオーディエンスを表し、規模を見積もったり、リーチや地域で分けたり、近いコミュニティのメンバー構成と比べたりできます。

X Community Members API の主な機能

  • コミュニティのリンクからメンバー一覧を取得https://x.com/i/communities/<id> のリンクを1つ以上貼り付けると、各コミュニティのメンバー全員がそれぞれ1行のプロフィールとして返ります。
  • 各メンバーの人物像行には username、表示名、text に入ったプロフィール文、アイコン画像、ヘッダー画像、ウェブサイト、本人が記載した所在地が含まれ、エクスポートだけでメンバーを特定し、どんな人かを説明できます。
  • メンバーごとのリーチmetrics には followers_count、following_count、posts_count が入り、コミュニティ内の影響力の大きい声と、静かな大多数を分けられます。
  • 認証状態とアカウント歴is_verified、is_private と、メンバーのXアカウントが作成された日である published_at から、一覧の各人がどれだけ定着しているかがひと目でわかります。

X Community Members API のパラメータ

パラメータ必須説明
urls必須https://x.com/i/communities/<numeric_id> 形式の公開Xコミュニティのリンクで、1行に1つずつ入力します。
results_limit任意コミュニティごとに返すメンバー数です。20〜2,000の範囲で20の倍数を指定し、デフォルトは100です。

X Community Members API の使い方

コミュニティのリンクを送信し、メンバーのプロフィールをページごとに読み取ります。

  1. {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} を /v1/x/community-members に 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/community-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/communities/1493446837214187523"],"results_limit":100}'

# results_limit is applied to each community in urls, so two links can return up to 200 members here.

X Community Members API の主なユースケース

  • コミュニティのオーディエンス分析: location.name でメンバーをグループ化し、text のプロフィール文から職種や関心を拾い、followers_count をグラフにして、実際にどんな人がコミュニティに参加したかを描き出します。
  • 提携候補メンバーの絞り込み: metrics.followers_count でメンバーを並べ替え、認証済みのアカウントを残し、website とプロフィール文を使って、ニッチな分野で連絡する価値のあるクリエイターを選びます。
  • 2つのコミュニティの重なりを測る: 関連する2つのコミュニティのメンバーをエクスポートし、id で照合して、両方に所属している人数を数えます。
  • 新規アカウントの割合をチェック: 最近の published_at と少ない posts_count・followers_count を組み合わせ、コミュニティのメンバーのうち新しく作られたアカウントやほとんど活動していないアカウントの割合を確認します。

X Community Members API 活用のヒント

  • メンバー構成を比較する予定なら、1タスクにつき1コミュニティを送信してください。メンバーの行にはプロフィールだけが入っているため、各行とコミュニティを結び付けるのはタスクの入力です。
  • まず X Community または X Communities Search で members_count を確認し、results_limit をそれを上回る次の20の倍数に設定すると、1つのタスクで一覧全体をリクエストできます。
  • 国別にまとめる前に location.name を正規化してください。ここにはメンバーが入力した「Sydney」のような自由記述の場所が入り、city や country のフィールドは空であることが多いです。

X Community Members API 以外に別の種類の公開Xデータが必要な場合は、これらのAPIをご利用ください。

  • Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
  • X Followers List API — 1つ以上のXユーザー名について、公開フォロワーのアカウント情報と表示中のプロフィール指標を取得します。
  • X Following List API — 公開Xアカウントがフォローしているプロフィールを、アカウント情報、プロフィール文、アカウントシグナル、表示中のカウント、元のユーザー名とともに取得します。
  • X Community API — コミュニティのリンクから、説明、メンバー数、ルール、参加ポリシーを取得します。
  • X Account Location API — アカウントの拠点となる国、Xへの接続方法、登録日、ユーザー名の変更回数を確認します。
  • X Community Moderators API — コミュニティを運営する管理者とモデレーターのプロフィールを取得します。

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

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

X Community Members API — よくある質問

X Community Members APIは、公開Xコミュニティの /i/communities/ リンクからメンバーをエクスポートするためのプログラムインターフェースです。メンバーごとに、ユーザー名、プロフィール文、所在地、ウェブサイト、認証状態、フォロワー数・フォロー数・ポスト数を含むプロフィールを1件返します。

はい。入力はコミュニティのリンクだけなので、一度も参加したことのない公開コミュニティのメンバーもエクスポートでき、Xへのログインも必要ありません。

X Communities Search でキーワードを検索してください。各結果にはコミュニティの url が含まれ、そのままこのエンドポイントに渡せます。

最大2,000人です。results_limit には20〜2,000の範囲で20の倍数を指定でき、デフォルトは100で、リクエスト内のコミュニティリンクごとに個別に数えられます。

いいえ。published_at はメンバーのXアカウントが作成された日です。コミュニティへの参加日は結果に含まれません。

リクエスト内のコミュニティが1つも見つからない場合、タスクは失敗し、クレジットは全額返金されます。一部だけが見つからない場合は、それ以外のコミュニティのメンバーが返ります。