x/
community-moderators

公開Xコミュニティのリンクから、運営している管理者とモデレーターを見つけます。各人のプロフィール、プロフィール文、ウェブサイト、認証フラグ、フォロワー数などを1つのタスクで返します。

X Community Moderators API

管理者とモデレーターをまとめて取得
コミュニティごとにチーム全員
連絡に使えるプロフィール
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

X Community Moderators

Xコミュニティのモデレーターとは、コミュニティの話題がそれないように保つ管理者とモデレーターのことで、ルールを書き、どのポストやメンバーを残すかを決める人たちであり、それぞれにプロフィール文、ウェブサイト、所在地、認証状態、フォロワー数を示す公開プロフィールがあります。そのチームに誰がいて、各人が個人としてどれだけのリーチを持っているかがわかれば、コミュニティについて誰に相談すべきか、実際に誰が背後にいるのかが見えてきます。

X Community Moderators API の主な機能

  • モデレーションチーム全員を一度に各コミュニティのリンクから、すべての管理者とモデレーターが1つのタスクでまとめて返り、結果の件数はチームの規模そのものに合わせて決まります。
  • 連絡に使えるプロフィールチームの各メンバーには username、表示名、text に入ったプロフィール文、ウェブサイト、所在地、アイコン画像、ヘッダー画像が付き、たいていは連絡方法を判断するのに十分です。
  • 各モデレーターの影響力フォロワー数・フォロー数・ポスト数が is_verified、アカウント作成日である published_at と並ぶため、コミュニティが定着したアカウントによって運営されているかを確認できます。

X Community Moderators API のパラメータ

パラメータ必須説明
urls必須管理者とモデレーターを取得したい公開Xコミュニティのリンクで、いずれも https://x.com/i/communities/<numeric_id> の形式です。

X Community Moderators API の使い方

コミュニティのリンクを送信し、そのモデレーションチームを読み取ります。

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

# Admins and moderators arrive together as profile rows, the whole team for each community.

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

  • コミュニティへのスポンサーシップやAMAの提案: モデレーターの名前、プロフィール文、ウェブサイトのリンクを使い、コミュニティのフィードに何を載せるかを決める人たちに連絡します。
  • 力を入れる前のコミュニティの見極め: 投稿、スポンサー、参加の前に、運営チームが認証済みか、published_at から見たアカウントの古さ、各自のフォロワー規模を確認します。
  • 複数のコミュニティを運営する人の発見: ニッチな分野のコミュニティのモデレーションチームを集め、id でプロフィールを照合して、複数のコミュニティでモデレーターを務めるアカウントを見つけます。

X Community Moderators API 活用のヒント

  • 誰がどのコミュニティをモデレートしているかを知る必要がある場合は、コミュニティごとに個別のタスクにしてください。プロフィールの行は人物を表し、コミュニティを特定するのは送信したリンクです。
  • website の値には、Xがプロフィールに表示する t.co の短縮リンクが入っているため、保存や利用の前に展開してください。
  • モデレーターがブランドやプロジェクトのアカウントの場合は、text のプロフィール文にある @ハンドルを確認してください。「Tweets by @marckohlbrugge」のように、背後にいる人物がそこに書かれていることがよくあります。

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

  • Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
  • Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
  • X Followers List API — 1つ以上のXユーザー名について、公開フォロワーのアカウント情報と表示中のプロフィール指標を取得します。
  • X Following List API — 公開Xアカウントがフォローしているプロフィールを、アカウント情報、プロフィール文、アカウントシグナル、表示中のカウント、元のユーザー名とともに取得します。
  • X Community API — コミュニティのリンクから、説明、メンバー数、ルール、参加ポリシーを取得します。
  • X Community Members API — コミュニティのメンバーを、自己紹介とフォロワー数を含むプロフィールとして書き出します。

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

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

X Community Moderators API — よくある質問

X Community Moderators APIは、公開Xコミュニティの /i/communities/ リンクから管理者とモデレーターを取得するためのプログラムインターフェースです。チームの各メンバーを、ユーザー名、プロフィール文、ウェブサイト、所在地、認証状態、フォロワー数を含むプロフィールとして返します。

ここでコミュニティのリンクを送信すると、管理者を含むチーム全員を取得できます。各行はプロフィールで役割のラベルは付かないため、結果からわかるのはチームに誰がいるかです。その1アカウントが必要な場合は、X Community API がコミュニティの作成者を返します。

全員です。このエンドポイントには results_limit がなく、コミュニティのすべての管理者とモデレーターが同じタスクで返ります。

はい。urls にはコミュニティのリンクのリストを指定でき、各コミュニティのチーム全員が同じタスクで返ります。

送信したコミュニティが1つも見つからない場合、タスクは失敗し、料金は全額返金されます。一部だけが見つからないバッチでは、残りのコミュニティのチームが返ります。