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 の使い方
コミュニティのリンクを送信し、メンバーのプロフィールをページごとに読み取ります。
- {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} を /v1/x/community-members に 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/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 のフィールドは空であることが多いです。
関連API
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 — コミュニティを運営する管理者とモデレーターのプロフィールを取得します。
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters 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 Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API